立即迁移到 Netlify

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

Gatsby Cloud 特有的环境变量

以下环境变量允许您配置 Gatsby Cloud 的功能

  • NODE_VERSION:指定您的项目应使用的 Node.js 版本。例如,NODE_VERSION=10。默认为 14
  • NPM_TOKEN:用于访问私有 npm 模块。
  • NPM_REGISTRY:用于设置私有注册表的 URL。
  • YARN_FLAGS:传递给 yarn 命令的标志。
  • NODE_OPTIONS:作为 Node.js 的选项传递。例如,- NODE_OPTIONS=--max-old-space-size=4096
  • PREFIX_PATHS:设置为 true 以在 gatsby build 期间启用 --prefix-paths 标志。请参阅有关 prefix-paths 的文档。

只读变量

这些变量在构建和预览环境之间是预定义的。它们会自动设置,并且无法更改。您可以在 gatsby-config.js 或任何其他通常引用环境变量的地方引用它们。

  • BRANCH:当前 git 分支的名称。可用于根据分支切换环境变量。
  • CI:始终为 true
  • GATSBY_CLOUD:始终为 true。可用于检查您的构建是否在 Gatsby Cloud 上运行。
  • GATSBY_IS_PREVIEW:仅在 CMS 预览环境中为 true,适用于 旧版预览构建器和增量预览构建器
  • NODE_ENV:
    • 对于生产构建和拉取请求构建,为 production
    • 对于使用 旧版预览构建器 的 CMS 预览,为 development
    • 对于使用新的 增量预览构建器 的 CMS 预览,为 production
    • 无论环境变量的值如何,CMS 预览构建仍使用预览数据。

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