Vercel

完整的 Vercel CLI 参考和文档访问。

使用时机

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

文档

以 Markdown 格式获取任何 Vercel 文档页面：

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 [路径]

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

选项：

• --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 [路径]

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

vercel pull

环境变量

vercel env

管理环境变量。

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

环境： 开发环境、预览环境、生产环境

示例：

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

域名与别名

vercel domains

管理域名。

vercel domains list                          # 列出域名
vercel domains add <域名> <项目>        # 添加域名
vercel domains inspect <域名>              # 显示域名信息
vercel domains remove <域名>               # 移除域名
vercel domains buy <域名>                  # 购买域名
vercel domains transfer-in <域名>          # 将域名转移到 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 <部署网址或ID>

vercel rollback [网址|ID]

回滚到之前的部署。

vercel rollback
vercel rollback <部署网址或ID>

vercel redeploy [网址|ID]

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

vercel redeploy <部署网址或ID>

vercel rm <ID>/vercel remove

移除一个部署。

vercel rm <部署网址或ID>

认证与团队

vercel login [邮箱]      # 登录或创建账户
vercel logout             # 登出
vercel whoami             # 显示当前用户
vercel switch [范围]     # 切换范围/团队
vercel teams              # 管理团队

其他命令

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

全局选项

所有命令均可用：

快速参考