立即迁移到 Netlify

Netlify 宣布 Gatsby Cloud 的下一次迭代。 了解更多

管理环境变量

环境变量允许您为 Gatsby 站点提供特定于环境的配置。环境变量的典型用例是在不将值硬编码到源代码中的情况下,为应用程序提供机密的 API 令牌。

在使用 Gatsby Cloud 时,您将有两个可以配置的环境

  1. 生产构建和拉取请求构建
  2. CMS 预览

本指南介绍了如何设置环境变量,并假定您已经创建了站点。

设置环境变量

可以通过仪表板菜单,点击 站点设置 > 常规 > 环境变量 来访问环境变量。

Setting environment variables in Gatsby Cloud

点击 编辑变量 图标来添加或更新变量。第一个字段是变量的 名称,第二个字段是

  • 构建变量 适用于生产构建和拉取请求构建
  • 预览变量 适用于 CMS 预览 在 Gatsby Cloud 中编辑环境变量

完成构建和预览变量的编辑后,点击 保存 以确认更改。

注意:编辑环境变量将触发您的站点重新构建。

批量复制/添加变量

为了方便起见,您可以批量复制/添加环境变量。通过点击“编辑变量”然后点击“批量复制变量”按钮,复制构建或预览环境的所有变量。

要批量添加变量,请点击“批量添加变量”按钮。使用 name=value 格式,每行输入一个变量。

Add many environment variables at once

批量添加的变量不会覆盖现有变量,而是追加到当前列表中。但是,您可以在添加新变量后删除旧变量。

访问环境变量 您可以通过引用 process.env.<variable name> 来在源代码中访问您设置的环境变量。例如

立即开始构建,在 Netlify!
在 GitHub 上编辑此页面
©2025Gatsby, Inc.