系统环境变量

通过设置特定的环境变量,你可以更改 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.json 中的 packageManager 字段。你可能会遇到

错误和意外的缓存行为

当禁用此检查时。使用 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 可用时出现的更新通知。你也可以根据生态系统约定使用

NO_UPDATE_NOTIFIER

TURBO_PLATFORM_ENV

在受支持的 CI 环境 (Vercel) 中配置的环境变量键的 CSV 列表。 注意:此变量旨在供希望实现零配置环境变量的平台使用。你不应作为最终用户使用此变量。

TURBO_PLATFORM_ENV_DISABLED 禁用检查在你的

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_TEAM

TURBO_TEAMID

与你的仓库关联的帐户标识符。当使用

时,这是你的团队 ID。 TURBO_TELEMETRY_MESSAGE_DISABLED

禁用通知你

遥测 已启用的消息。 远程缓存.

TURBO_TOKEN

用于身份验证以访问

TURBO_UI

Bearer 令牌

变量描述
当传递 true 或 1 时启用 TUI,当传递 false 或 0 时禁用。任务中的环境变量
Turborepo 将在你的任务执行时使其可以使用以下环境变量TURBO_HASH
当前正在运行的任务的哈希值。