SuperAPI AI 工具集

vercel-multi-env-setup

编程与开发

查看项目

更新于 10-15 23:30

技能介绍

用途:在 Vercel 上为开发、预览、生产三套内置环境配置作用域环境变量,并可创建 staging 等自定义环境,按分支绑定域名,实现各环境配置与密钥隔离。

主要能力:使用 vercel env add 为变量指定 production、preview、development 作用域,或用 vercel env ls 查看作用域;通过 Vercel REST API(如 POST /v9/projects/{project}/env,支持 upsert=true)批量创建与更新变量;创建自定义环境(POST /v1/projects/{project}/custom-environments)并绑定分支;为指定分支分配自定义域名;在代码中用 VERCEL_ENV、VERCEL_URL 做运行时环境检测并加生产保护;用 vercel env pull 拉取变量到本地。变量类型含 plain、encrypted、sensitive、system。

使用方式:需项目已关联并部署,建议各环境使用独立数据库实例,可使用 VERCEL_TOKEN 调用 API。命令示例:vercel env add DATABASE_URL production;vercel env pull .env.development.local;vercel env pull --environment=preview .env.preview.local。

适用场景:按环境隔离数据库连接与密钥、为 PR 提供独立预览配置、搭建 staging 环境与域名、本地开发同步变量。

限制与注意:sensitive 类型变量保存后不可读取,值丢失需重新添加;预览环境变量未加入 Preview 目标会导致其未定义;错误作用域可能让预览环境误连生产数据库;.env*.local 文件应加入 .gitignore;自定义环境需分支名与 slug 匹配才触发。具体收费、价格与完整错误处理步骤暂未提供。