名称： vercel
描述： 通过完整的 CLI 参考来部署应用和管理项目。包含部署、项目、域名、环境变量等命令，并可实时访问文档。
元数据： {"clawdbot":{"emoji":"▲","requires":{"bins":["vercel","curl"]}}}

Vercel

完整的 Vercel CLI 参考与文档访问指南。

何时使用

• 将应用程序部署到 Vercel
• 管理项目、域名和环境变量
• 运行本地开发服务器
• 查看部署日志与状态
• 查阅 Vercel 官方文档

文档

获取任意 Vercel 文档页面（Markdown 格式）：

curl -s "https://vercel.com/docs/<path>" -H 'accept: text/markdown'

获取完整站点地图以发现所有可用页面：

curl -s "https://vercel.com/docs/sitemap.md" -H 'accept: text/markdown'

CLI 命令

部署

vercel / vercel deploy [path]

部署当前目录或指定路径。

选项：
- --prod - 部署到生产环境
- -e KEY=VALUE - 设置运行时环境变量
- -b KEY=VALUE - 设置构建时环境变量
- --prebuilt - 部署预构建输出（与 vercel build 配合使用）
- --force - 即使未更改也强制新部署
- --no-wait - 不等待部署完成
- -y, --yes - 跳过提示，使用默认值

示例：

vercel                          # 部署当前目录
vercel --prod                   # 部署到生产环境
vercel /path/to/project         # 部署指定路径
vercel -e NODE_ENV=production   # 附带环境变量
vercel build && vercel --prebuilt  # 预构建部署

vercel build

在本地构建项目到 ./vercel/output 目录。

vercel build

vercel dev [dir]

启动本地开发服务器。

选项：
- -l, --listen <URI> - 端口/地址（默认：0.0.0.0:3000）

示例：

vercel dev                  # 在 3000 端口启动
vercel dev --listen 8080    # 在 8080 端口启动

项目管理

vercel link [path]

将本地目录链接到 Vercel 项目。

选项：
- -p, --project <NAME> - 指定项目名称
- -y, --yes - 跳过提示

示例：

vercel link
vercel link --yes
vercel link -p my-project

vercel projects

管理项目。

vercel projects list              # 列出所有项目
vercel projects add <name>        # 创建新项目
vercel projects inspect [name]    # 显示项目详情
vercel projects remove <name>     # 删除项目

vercel pull [path]

从云端拉取项目设置和环境变量。

vercel pull

环境变量

vercel env

管理环境变量。

vercel env list [environment]                    # 列出环境变量
vercel env add <name> [environment]              # 添加环境变量
vercel env remove <name> [environment]           # 移除环境变量
vercel env pull [filename]                       # 拉取到 .env.local 文件

环境类型： development（开发）、preview（预览）、production（生产）

示例：

vercel env list production
vercel env add DATABASE_URL production
vercel env pull .env.local

域名与别名

vercel domains

管理域名。

vercel domains list                          # 列出域名
vercel domains add <domain> <project>        # 添加域名
vercel domains inspect <domain>              # 显示域名信息
vercel domains remove <domain>               # 移除域名
vercel domains buy <domain>                  # 购买域名
vercel domains transfer-in <domain>          # 将域名转入 Vercel

vercel alias

管理部署别名。

vercel alias list                                    # 列出别名
vercel alias set <deployment> <alias>                # 创建别名
vercel alias remove <alias>                          # 移除别名

示例：

vercel alias set my-app-abc123.vercel.app my-app.vercel.app
vercel alias set my-app-abc123.vercel.app custom-domain.com

部署管理

vercel ls [app] / vercel list

列出部署。

vercel ls
vercel ls my-project

vercel inspect [id]

显示部署信息。

vercel inspect <deployment-url-or-id>

vercel logs <url|id>

查看部署的运行时日志。

选项：
- -j, --json - 以 JSON 格式输出（兼容 jq）

示例：

vercel logs my-app.vercel.app
vercel logs <deployment-id> --json
vercel logs <deployment-id> --json | jq 'select(.level == "error")'

vercel promote <url|id>

将部署提升至生产环境。

vercel promote <deployment-url-or-id>

vercel rollback [url|id]

回滚到之前的部署。

vercel rollback
vercel rollback <deployment-url-or-id>

vercel redeploy [url|id]

重新构建并部署之前的部署。

vercel redeploy <deployment-url-or-id>

vercel rm <id> / vercel remove

移除部署。

vercel rm <deployment-url-or-id>

认证与团队

vercel login [email]      # 登录或创建账户
vercel logout             # 登出
vercel whoami             # 显示当前用户
vercel switch [scope]     # 切换作用域/团队
vercel teams              # 管理团队

其他命令

vercel open               # 在仪表板中打开项目
vercel init [example]     # 从示例初始化项目
vercel install [name]     # 安装市场集成
vercel integration        # 管理集成
vercel certs              # 管理 SSL 证书
vercel dns                # 管理 DNS 记录
vercel bisect             # 二分查找引入错误的部署

全局选项

所有命令均可使用：

速查表