环境变量参考
Task 提供多种配置方式。这些方法按以下优先级顺序依次解析(最后一项优先级最高):
本文档将介绍三种选项中的第一种:环境变量。所有 Task 专用变量均以 TASK_ 开头,并会覆盖配置文件中对应的设置。
变量说明
TASK_TEMP_DIR
定义 Task 临时目录的位置,用于存储校验和和临时元数据。可采用相对路径(如 tmp/task)或绝对路径(如 /tmp/.task 或 ~/.task)。相对路径基于根 Taskfile 目录,而非工作目录。默认值为:./.task。
TASK_CORE_UTILS
此环境变量控制 Bash 解释器使用其 Go 语言实现的核心工具集还是系统自带工具集。有效值为 true(1)或 false(0)。默认情况下,Windows 系统为 true,其他操作系统为 false。未来考虑在所有平台上默认启用此功能。
TASK_REMOTE_DIR
定义 Task 远程临时目录的位置,用于缓存远程文件。可采用相对路径(如 tmp/task)或绝对路径(如 /tmp/.task 或 ~/.task)。相对路径基于根 Taskfile 目录,而非工作目录。默认值为:./.task。
TASK_OFFLINE
通过环境变量设置 --offline 标志。仅适用于远程实验。命令行标志 --offline 优先于此环境变量。
FORCE_COLOR
强制启用彩色输出。
自定义颜色
所有颜色变量均为 ANSI 颜色代码。可通过分号分隔多个代码(例如:31;1 可使文本显示为粗体红色)。Task 同时支持 8 位色(256 色)。可通过序列 38;2;R:G:B 指定前景色,48;2;R:G:B 指定背景色,其中 R、G 和 B 需替换为 0 到 255 之间的数值。
为方便起见,支持使用简化的逗号分隔语法指定前景色:R,G,B。例如 255,0,0 等同于 38;2;255:0:0。
变量及默认值如下表所示:
| 环境变量 | 默认值 |
|---|---|
TASK_COLOR_RESET | 0 |
TASK_COLOR_RED | 31 |
TASK_COLOR_GREEN | 32 |
TASK_COLOR_YELLOW | 33 |
TASK_COLOR_BLUE | 34 |
TASK_COLOR_MAGENTA | 35 |
TASK_COLOR_CYAN | 36 |
TASK_COLOR_BRIGHT_RED | 91 |
TASK_COLOR_BRIGHT_GREEN | 92 |
TASK_COLOR_BRIGHT_YELLOW | 93 |
TASK_COLOR_BRIGHT_BLUE | 94 |
TASK_COLOR_BRIGHT_MAGENTA | 95 |
TASK_COLOR_BRIGHT_CYAN | 96 |