SuperAPI AI 工具集

vercel-cli

部署与运维

查看项目

更新于 10-16 07:28

技能介绍

用途:Vercel CLI(命令为 vercel 或 vc)用于从命令行部署、管理和开发 Vercel 平台上的项目。可用 vercel <command> -h 查看任意命令的完整参数。

主要能力与用法:安装与登录使用 npm i -g vercel、vercel login。项目关联分两种:vercel link 生成 .vercel/project.json,关联单个项目;vercel link --repo 生成 .vercel/repo.json,关联可能含多个项目的仓库,当项目不在根目录(如 apps/web)时建议使用。常用流程为 vercel pull、vercel dev(本地开发)、vercel deploy(预览部署)、vercel --prod(生产部署)。命令必须在包含 .vercel 的目录或其子目录中运行;从项目子目录运行可跳过选择项目的提示。

技能按主题提供参考文件路由:部署、本地开发、环境变量、CI/CD 自动化、域名与 DNS、项目与团队、日志指标与调试、Blob 存储、集成、Node.js 后端、monorepo、Bun 运行时、功能开关、高级 API 与 webhook、全局参数、首次设置。访问预览部署用 vercel curl;CLI 无对应命令时可用 vercel api 兜底。

限制与注意事项:monorepo 多项目时用 vercel link 会只跟踪一个项目,应改用 vercel link --repo;许多命令在缺少 .vercel 时会隐式执行 link,可能生成错误的 project.json,建议先显式关联。关联前用 vercel whoami 确认团队,用 vercel teams switch 切换。CI 中需加 --yes 跳过交互提示;vercel build 后部署需加 --prebuilt,否则构建产物被忽略;令牌应使用 VERCEL_TOKEN 环境变量而非 --token;不要关闭部署保护,改用 vercel curl 访问预览部署。相关技能包括 observability 与 vercel-flags。