请参见下方翻译（保留原始代码块和 Markdown 格式，不在此处重复）
Complete Vercel CLI reference and documentation access.
When to Use
- Deploying applications to Vercel
- Managing projects, domains, and environment variables
- Running local development server
- Viewing deployment logs and status
- Looking up Vercel documentation
Documentation
Fetch any Vercel docs page as markdown:
curl -s "https://vercel.com/docs/" -H 'accept: text/markdown'
Get the full sitemap to discover all available pages:
curl -s "https://vercel.com/docs/sitemap.md" -H 'accept: text/markdown'
CLI Commands
Deployment
vercel / vercel deploy [path]
Deploy the current directory or specified path.
Options:
--prod - Deploy to production-e KEY=VALUE - Set runtime environment variables-b KEY=VALUE - Set build-time environment variables--prebuilt - Deploy prebuilt output (use with vercel build)--force - Force new deployment even if unchanged--no-wait - Don't wait for deployment to finish-y, --yes - Skip prompts, use defaults
Examples:
vercel # deploy current directory
vercel --prod # deploy to production
vercel /path/to/project # deploy specific path
vercel -e NODE_ENV=production # with env var
vercel build && vercel --prebuilt # prebuilt deploy
vercel build
Build the project locally into
./vercel/output.
vercel build
vercel dev [dir]
Start local development server.
Options:
-l, --listen - Port/address (default: 0.0.0.0:3000)
Examples:
vercel dev # start on port 3000
vercel dev --listen 8080 # start on port 8080
Project Management
vercel link [path]
Link local directory to a Vercel project.
Options:
-p, --project - Specify project name-y, --yes - Skip prompts
Examples:
vercel link
vercel link --yes
vercel link -p my-project
vercel projects
Manage projects.
vercel projects list # list all projects
vercel projects add # create new project
vercel projects inspect [name] # show project details
vercel projects remove # delete project
vercel pull [path]
Pull project settings and env vars from cloud.
vercel pull
Environment Variables
vercel env
Manage environment variables.
vercel env list [environment] # list env vars
vercel env add [environment] # add env var
vercel env remove [environment] # remove env var
vercel env pull [filename] # pull to .env.local
Environments: development, preview, production
Examples:
vercel env list production
vercel env add DATABASE_URL production
vercel env pull .env.local
Domains & Aliases
vercel domains
Manage domain names.
vercel domains list # list domains
vercel domains add # add domain
vercel domains inspect # show domain info
vercel domains remove # remove domain
vercel domains buy # purchase domain
vercel domains transfer-in # transfer domain to Vercel
vercel alias
Manage deployment aliases.
vercel alias list # list aliases
vercel alias set # create alias
vercel alias remove # remove alias
Examples:
vercel alias set my-app-abc123.vercel.app my-app.vercel.app
vercel alias set my-app-abc123.vercel.app custom-domain.com
Deployments
vercel ls [app] / vercel list
List deployments.
vercel ls
vercel ls my-project
vercel inspect [id]
Display deployment information.
vercel inspect
vercel logs
View runtime logs for a deployment.
Options:
-j, --json - Output as JSON (compatible with jq)
Examples:
vercel logs my-app.vercel.app
vercel logs --json
vercel logs --json | jq 'select(.level == "error")'
vercel promote
Promote deployment to production.
vercel promote
vercel rollback [url|id]
Rollback to previous deployment.
vercel rollback
vercel rollback
vercel redeploy [url|id]
Rebuild and deploy a previous deployment.
vercel redeploy
vercel rm / vercel remove
Remove a deployment.
vercel rm
Authentication & Teams
vercel login [email] # log in or create account
vercel logout # log out
vercel whoami # show current user
vercel switch [scope] # switch between scopes/teams
vercel teams # manage teams
Other Commands
vercel open # open project in dashboard
vercel init [example] # initialize from example
vercel install [name] # install marketplace integration
vercel integration # manage integrations
vercel certs # manage SSL certificates
vercel dns # manage DNS records
vercel bisect # binary search for bug-introducing deployment
Global Options
Available on all commands:
| Option | Description |
|---|
-h, --help | Show help |
-v, --version | Show version |
-d, --debug | Debug mode |
-t, --token | Auth token |
-S, --scope | Set scope/team |
--cwd | Working directory |
-A, --local-config | Path to vercel.json |
--no-color | Disable colors |
Quick Reference
| Task | Command |
|---|
| Deploy | vercel or vercel --prod |
| Dev server | vercel dev |
| Link project | vercel link |
| List deployments | vercel ls |
| View logs | vercel logs |
| Add env var | vercel env add |
| Pull env vars | vercel env pull |
| Rollback | vercel rollback |
| Add domain | vercel domains add |
| Get docs | curl -s "https://vercel.com/docs/" -H 'accept: text/markdown' |
| Docs sitemap | curl -s "https://vercel.com/docs/sitemap.md" -H 'accept: text/markdown' |
by