Configuration
选项概览
了解管理 turbo 调用行为的三种方式：turbo.json 配置、系统环境变量和 CLI 标志
有三种方式来管理 turbo 调用的行为：
上述三种策略按优先级顺序列出。当提供标志值时，对于相同的系统环境变量或 turbo.json 配置，将使用标志的值。因此，我们建议使用：
turbo.json配置作为默认值- 系统环境变量用于每个环境的覆盖
- 标志用于每次调用的覆盖
选项表
缓存
消息
| 行为 | 标志 | 环境变量 | turbo.json |
|---|---|---|---|
| 禁用版本打印 | - | TURBO_PRINT_VERSION_DISABLED | - |
| 禁用遥测消息 | - | TURBO_TELEMETRY_MESSAGE_DISABLED | - |
禁用全局 turbo 警告 | - | TURBO_GLOBAL_WARNING_DISABLED | - |
| 无更新通知器 | - | TURBO_NO_UPDATE_NOTIFIER | noUpdateNotifier |
任务运行和日志
| 行为 | 标志 | 环境变量 | turbo.json |
|---|---|---|---|
| 终端 UI | --ui | TURBO_UI | ui |
| 运行受影响的任务 | --affected | - | - |
| 禁用包管理器检查 | --dangerously-disable-package-manager-check | TURBO_DANGEROUSLY_DISABLE_PACKAGE_MANAGER_CHECK | dangerouslyDisablePackageManagerCheck |
| 受影响的基础引用 | - | TURBO_SCM_BASE | - |
| 受影响的头部引用 | - | TURBO_SCM_HEAD | - |
| 仅运行直接指定的任务 | --only | - | - |
| 任务并发 | --concurrency | TURBO_CONCURRENCY | - |
| 任务日志顺序 | --log-order | TURBO_LOG_ORDER | - |
| 当前工作目录 | --cwd | - | - |
| 流式日志前缀 | --log-prefix | - | - |
| 任务日志输出级别 | --output-logs-option | - | outputLogs |
| 全局输入 | --global-deps | - | globalDependencies |
| 终端颜色 | --color | FORCE_COLOR | - |
环境变量
| 行为 | 标志 | 环境变量 | turbo.json |
|---|---|---|---|
| 环境变量模式 | --env-mode | - | envMode |
| 供应商环境变量 | - | TURBO_CI_VENDOR_ENV_KEY | - |
| 框架变量异常 | --framework-inference | - | - |
调试输出
| 行为 | 标志 | 环境变量 | turbo.json |
|---|---|---|---|
| 运行摘要 | --summarize | TURBO_RUN_SUMMARY | - |
| 图形可视化 | --graph | - | - |
| 试运行 | --dry | - | - |
身份验证
| 行为 | 标志 | 环境变量 | turbo.json |
|---|---|---|---|
| 登录 URL | - | TURBO_LOGIN | remoteCache.loginUrl |
| 团队名称（用于多团队远程缓存） | --team | TURBO_TEAM | - |
| 团队 ID（用于多团队远程缓存） | - | TURBO_TEAMID | - |
| 身份验证令牌 | --token | TURBO_TOKEN | - |
其他
| 行为 | 标志 | 环境变量 | turbo.json |
|---|---|---|---|
| 二进制文件路径 | - | TURBO_BINARY_PATH | - |
下载本地 turbo | - | TURBO_DOWNLOAD_LOCAL_ENABLED | - |
| 守护进程 | --daemon / --no-daemon | - | daemon |