Vercel 环境变量

环境变量是在源代码之外配置的键值对，因此每个值都可以根据环境而变化

您的源代码可以读取这些值，在“构建步骤”或“函数执行”期间更改行为

所有值都在静止状态下加密，并对任何具有访问项目权限的用户可见。使用非敏感和敏感数据（例如令牌）都是安全的

环境变量的更改不会应用于先前的部署，它们只适用于新的部署

环境变量大小

所有计划上的开发者在 Vercel 上每次部署可以使用总共 64KB 的环境变量。此限制适用于所有变量的组合，因此没有单个变量可以大于 64KB。

总大小包括通过仪表板或 CLI 配置的任何变量。

在64KB环境变量的支持下，您可以添加大型值以进行身份验证令牌、JWT或证书

使用以下运行时的部署可以支持更大的64KB环境：

此外，PHP社区运行时也支持64KB环境

注意：虽然 Vercel 允许环境变量的总大小达到 64KB，但边缘函数和边缘中间件每个环境变量的大小限制为 5KB。

对于每个环境变量，您可以选择一个或多个环境来应用该变量：

生产环境: 选中后，环境变量将应用于您的下一个生产部署。要创建生产部署，请将提交推送到生产分支或运行 vercel --prod

预览环境: 环境变量将应用于您的下一个预览部署。预览部署是在您推送到非生产分支或运行 vercel 时创建的

开发环境: 当使用 vercel dev 或您喜欢的开发命令在本地运行项目时，将使用这类环境变量。要下载开发环境变量，请运行 vercel env pull

注意：您需要 Vercel CLI 版本 22.0.0 或更高版本才能使用本节中描述的功能。

预览环境变量适用于不匹配生产分支的任何 Git 分支的部署。当您添加预览环境变量时，您可以选择应用于所有预览分支，也可以选择特定分支。

当您推送到分支时，将使用预览环境变量和特定于分支的变量（如果有）。任何特定于分支的变量都将覆盖具有相同名称的其他变量。这意味着您不需要为每个分支复制所有现有的预览环境变量-您只需要添加要覆盖的值即可。

注意：您需要 Vercel CLI 版本 21.0.1 或更高版本才能使用本节中描述的功能。

可以使用 Vercel CLI 提供的 vercel env pull 命令将为开发环境创建的环境变量下载到本地开发设置中：

vercel env pull
Downloading Development Environment Variables for Project my-lovely-project
✅ Created .env file [510ms]

运行该命令将在当前目录中创建一个 .env 文件，然后可以被您的框架的开发命令（如 next dev ）使用。

如果您正在使用 vercel dev ，则无需运行 vercel env pull ，因为 vercel dev 会自动将开发环境变量下载到内存中。

如果觉得文章对你有用，请随意赞赏

Vercel 环境变量

lppx

2023-03-28

2023-03-28

CC BY 4.0