选项概述

有三种方法可以管理 turbo 调用的行为：

¥There are three ways to manage the behavior of a turbo invocation:

上面列出的三种策略按优先顺序排列。如果提供了标志值，则对于相同的系统环境变量或 turbo.json 配置，将使用该标志的值。因此，我们建议使用：

¥The three strategies listed above are in order of precedence. Where a flag value is provided, for the same System Environment Variable or turbo.json configuration, the value for the flag will be used. Because of this, we recommend using:

turbo.json 默认配置

¥turbo.json configuration for defaults
用于每个环境覆盖的系统环境变量

¥System Environment Variables for per-environment overrides
每次调用覆盖的标志

¥Flags for per-invocation overrides

选项表

¥Options table

缓存

¥Caching

行为	标志	环境变量	turbo.json
强制运行任务	`--force`	`TURBO_FORCE`	`cache`
远程缓存超时	`--remote-cache-timeout`	`TURBO_REMOTE_CACHE_TIMEOUT`	`remoteCache.timeout`
远程缓存上传超时	*	`TURBO_REMOTE_CACHE_UPLOAD_TIMEOUT`	`remoteCache.uploadTimeout`
缓存签名密钥	*	`TURBO_REMOTE_CACHE_SIGNATURE_KEY`	`signature`
预检请求	`--preflight`	`TURBO_PREFLIGHT`	`remoteCache.preflight`
远程缓存基准 URL	*	`TURBO_API`	`remoteCache.apiUrl`
缓存源	`--cache`	`TURBO_CACHE`	*
本地缓存目录	`--cache-dir`	`TURBO_CACHE_DIR`	`cacheDir`

消息

¥Messages

行为	标志	环境变量	turbo.json
禁用版本打印	*	`TURBO_PRINT_VERSION_DISABLED`	*
禁用遥测消息	*	`TURBO_TELEMETRY_MESSAGE_DISABLED`	*
禁用全局 `turbo` 警告	*	`TURBO_GLOBAL_WARNING_DISABLED`	*
不支持更新通知程序	*	`TURBO_NO_UPDATE_NOTIFIER`	`noUpdateNotifier`

任务运行和日志

¥Task running and logs

行为	标志	环境变量	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`	*	*
任务日志顺序	`--log-order`	`TURBO_LOG_ORDER`	*
当前工作目录	`--cwd`	*	*
流日志前缀	`--log-prefix`	*	*
任务日志输出级别	`--output-logs-option`	*	`outputLogs`
全局输入	`--global-deps`	*	`globalDependencies`
终端颜色	`--color`	FORCE_COLOR	*

环境变量

¥Environment variables

行为	标志	环境变量	turbo.json
环境变量模式	`--env-mode`	*	`envMode`
供应商环境变量	*	`TURBO_CI_VENDOR_ENV_KEY`	*
框架变量异常	`--framework-inference`	*	*

调试输出

¥Debugging outputs

行为	标志	环境变量	turbo.json
运行摘要	`--summarize`	`TURBO_RUN_SUMMARY`	*
图形可视化	`--graph`	*	*
试运行	`--dry`	*	*

身份验证

¥Authentication

行为	标志	环境变量	turbo.json
登录 URL	*	`TURBO_LOGIN`	`remoteCache.loginUrl`
团队名称（用于多团队远程缓存）	`--team`	`TURBO_TEAM`	*
团队 ID（用于多团队远程缓存）	*	`TURBO_TEAMID`	*
身份验证令牌	`--token`	`TURBO_TOKEN`	*

其他

¥Other

行为	标志	环境变量	turbo.json
二进制路径	*	`TURBO_BINARY_PATH`	*
下载本地 `turbo`	*	`TURBO_DOWNLOAD_LOCAL_ENABLED`	*
守护进程	`--daemon` / `--no-daemon`	*	`daemon`