Skip to content

环境变量参考

Task 提供多种配置方式。这些方法按以下优先级顺序依次解析(最后一项优先级最高):

本文档将介绍三种选项中的第一种:环境变量。所有 Task 专用变量均以 TASK_ 开头,并会覆盖配置文件中对应的设置。

变量说明

TASK_TEMP_DIR

定义 Task 临时目录的位置,用于存储校验和和临时元数据。可采用相对路径(如 tmp/task)或绝对路径(如 /tmp/.task~/.task)。相对路径基于根 Taskfile 目录,而非工作目录。默认值为:./.task

TASK_CORE_UTILS

此环境变量控制 Bash 解释器使用其 Go 语言实现的核心工具集还是系统自带工具集。有效值为 true1)或 false0)。默认情况下,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 指定背景色,其中 RGB 需替换为 0 到 255 之间的数值。

为方便起见,支持使用简化的逗号分隔语法指定前景色:R,G,B。例如 255,0,0 等同于 38;2;255:0:0

变量及默认值如下表所示:

环境变量默认值
TASK_COLOR_RESET0
TASK_COLOR_RED31
TASK_COLOR_GREEN32
TASK_COLOR_YELLOW33
TASK_COLOR_BLUE34
TASK_COLOR_MAGENTA35
TASK_COLOR_CYAN36
TASK_COLOR_BRIGHT_RED91
TASK_COLOR_BRIGHT_GREEN92
TASK_COLOR_BRIGHT_YELLOW93
TASK_COLOR_BRIGHT_BLUE94
TASK_COLOR_BRIGHT_MAGENTA95
TASK_COLOR_BRIGHT_CYAN96