用途:在使用访问令牌而非交互式登录的情况下,通过 Vercel CLI 部署和管理 Vercel 项目,适用于“部署到 Vercel”“设置 Vercel”“为 Vercel 添加环境变量”等场景。
主要能力:定位令牌(环境变量中的 VERCEL_TOKEN、.env 文件中的 VERCEL_TOKEN 或其他命名、以及请求用户提供);定位项目与团队(VERCEL_ORG_ID、VERCEL_PROJECT_ID);安装与检查 CLI;部署(预览或生产);链接项目;管理环境变量;检查部署与日志;管理域名;处理 Stripe Projects 计划变更。
使用方式:先确保 Vercel CLI 已安装,运行 npm install -g vercel 并通过 vercel --version 检查。找到令牌后导出为环境变量,CLI 会原生读取,不要用 --token 标志传递。示例:export VERCEL_TOKEN=$(grep '^VERCEL_TOKEN=' .env | cut -d= -f2-)。拥有项目 ID 时可直接部署:vercel deploy -y --no-wait;带团队作用域:vercel deploy --scope <team-slug> -y --no-wait;生产仅在被明确要求时:vercel deploy --prod --scope <team-slug> -y --no-wait。检查状态用 vercel inspect <deployment-url>。无项目 ID 时先链接:vercel link --repo --scope <team-slug> -y,再部署。环境变量操作如 echo "value" | vercel env add VAR_NAME --scope <team-slug>、vercel env ls、vercel env pull、vercel env rm。域名操作如 vercel domains ls、vercel domains add。
适用场景:在 CI 或代理环境中以令牌认证方式操作 Vercel;需要预览部署、环境变量同步或部署状态检查时。
限制与约定:默认使用预览部署,仅在明确要求时才部署到生产;推送 git 前必须获得用户同意;不要把令牌放在命令行参数中;不要直接修改 .vercel/ 目录;不要在未链接目录运行 vercel project inspect 或 vercel link;不要在未获批准时执行付费或破坏性计划变更。Stripe Projects 计划变更的付费信息(如 Pro 计划每月 20 美元等)仅依据资料提供,实际以 Vercel 文档为准。缺失事实暂未提供。