系统环境变量

通过设置某些环境变量,您可以改变 Turborepo 的行为。这对于为不同的环境和机器创建特定的配置非常有用。

系统环境变量始终会被直接提供给您的 turbo 命令的标志值覆盖。

变量描述
FORCE_COLOR强制在终端日志中显示颜色
TURBO_API

设置远程缓存的基址 URL 远程缓存.

TURBO_BINARY_PATH

手动设置 turbo 二进制文件的路径。默认情况下, turbo 会自动发现二进制文件,因此您应该只在极少数情况下使用此选项。

TURBO_CACHE

控制缓存源的读取和写入。使用与

--cache

.

TURBO_CACHE_DIR

相同的语法 设置缓存目录,类似于使用

--cache-dir

标志。

TURBO_CI_VENDOR_ENV_KEY

为您希望从 框架推断排除的环境变量设置前缀。注意:用户无需设置此项,支持的平台应自动配置此项。

TURBO_DANGEROUSLY_DISABLE_PACKAGE_MANAGER_CHECK

禁用对 package.jsonpackageManager 字段的检查。禁用此检查可能会导致 错误和意外的缓存行为。使用 true1 来禁用。

错误和意外的缓存行为

当禁用此检查时。

TURBO_DOWNLOAD_LOCAL_ENABLED

当全局 turbo 未找到本地版本时,启用安装正确的本地版本。

TURBO_FORCE

设置为 true 以强制所有任务完全运行,选择退出所有缓存。

TURBO_GLOBAL_WARNING_DISABLED

禁用全局 turbo 找不到本地版本可供使用时的警告。

TURBO_PRINT_VERSION_DISABLED

禁用打印正在执行的 turbo 版本。

TURBO_LOG_ORDER

设置 日志顺序。允许的值为 groupeddefault

TURBO_LOGIN

设置登录到 远程缓存 时使用的 URL。仅当自托管的远程缓存实现了一个动态生成令牌的端点时才需要。 远程缓存。仅当自托管的远程缓存实现了一个动态生成令牌的端点时才需要。

TURBO_NO_UPDATE_NOTIFIER

当有新版本的 turbo 可用时,移除出现的更新通知。您也可以根据生态系统的约定使用 turbo 可用时,移除出现的更新通知。您也可以根据 NO_UPDATE_NOTIFIER

TURBO_PLATFORM_ENV

一个 CSV 格式的、在支持的 CI 环境(Vercel)中配置的环境变量键。注意:此变量旨在供平台用于实现零配置环境变量。您不应作为最终用户使用此变量。

TURBO_PLATFORM_ENV_DISABLED

禁用将 turbo.json 中配置的环境变量与您支持的平台中设置的环境变量进行比较。 turbo.json 与您的支持平台中设置的环境变量进行比较。

TURBO_PREFLIGHT

在每次缓存伪影和分析请求之前启用发送预检请求。后续的上传和下载将遵循重定向。仅在配置了 远程缓存 时适用。

TURBO_REMOTE_CACHE_READ_ONLY

阻止写入 远程缓存 - 但仍允许读取。 远程缓存 - 但仍允许读取。

TURBO_REMOTE_CACHE_SIGNATURE_KEY

使用秘密密钥签名伪影。有关更多信息,请访问

伪影完整性部分

.

TURBO_REMOTE_CACHE_TIMEOUT

设置 turbo 从中获取伪影的超时(以秒为单位)。 远程缓存.

TURBO_REMOTE_CACHE_UPLOAD_TIMEOUT

设置 turbo 上传伪影到 远程缓存 的超时(以秒为单位)。 远程缓存.

TURBO_REMOTE_ONLY始终忽略所有任务的本地文件系统缓存。
TURBO_RUN_SUMMARY

在运行任务时生成 运行摘要当您运行任务时。

TURBO_SCM_BASE

--affected 在计算 base...head 的变化时使用的基准。

TURBO_SCM_HEAD

--affected 在计算 base...head 的变化时使用的头部。

TURBO_TEAM

与您的仓库关联的账户名。当使用

Vercel 远程缓存

,这是 您团队的 slug

TURBO_TEAMID

与您的存储库关联的帐户标识符。使用

Vercel 远程缓存

时,这是您团队的 ID。

TURBO_TELEMETRY_MESSAGE_DISABLED

禁用通知您 遥测 已启用的消息。 遥测 已启用的消息。

TURBO_TOKEN

用于身份验证以访问 远程缓存 的 Bearer 令牌。 远程缓存.

TURBO_UI

传入 true 或 1 时启用 TUI,传入 false 或 0 时禁用。

TURBO_CONCURRENCY

控制运行或监视模式下的

并发

设置。

TURBO_SSO_LOGIN_CALLBACK_PORT

覆盖身份验证过程中 SSO 登录回调服务器使用的默认端口(9789)。

任务中的环境变量

Turborepo 将在任务执行期间使其在您的任务中可用以下环境变量

变量描述
TURBO_HASH当前运行任务的哈希值。
TURBO_IS_TUI在使用 TUI 时,此变量设置为 true
TURBO_IS_MFE在使用 微前端 时,此变量设置为 microfrontends.json 中为应用程序定义的端口。