Taskfile 项目中 CLI 参数处理的新思路：从字符串到数组

在软件开发过程中，命令行参数处理是一个常见需求。Taskfile 作为一个流行的任务运行工具，近期社区针对其 CLI 参数处理方式提出了改进建议，这反映了现代开发工作流中对参数处理更精细控制的需求。

背景与现状

目前，Taskfile 通过 CLI_ARGS 变量来传递命令行参数，但这个变量将所有参数合并为一个经过 shell 引用的字符串。这种设计源于 Taskfile 早期版本只支持字符串变量的限制。虽然这种单一字符串的形式在某些场景下很方便（比如直接传递给 docker 等命令），但在需要单独处理每个参数时就显得不够灵活。

随着 Taskfile 引入了"任意类型"变量支持，现在数组类型已经成为可能，这为改进参数处理方式提供了新的机会。

改进方案

社区讨论后决定保持现有 CLI_ARGS 变量的字符串形式不变，同时新增一个 CLI_ARGS_LIST 数组变量。这种双变量方案具有以下优势：

1. 向后兼容：现有使用 CLI_ARGS 的 Taskfile 脚本无需修改
2. 灵活性增强：新变量提供直接访问单个参数的能力
3. 使用场景覆盖：
   • 字符串形式适合直接传递给外部命令
   • 数组形式便于参数遍历和单独处理

技术实现考量

这种设计类似于 POSIX shell 中 $* 和 $@ 的区别，既保持了简单场景的便捷性，又提供了复杂场景所需的灵活性。对于开发者而言，这意味着：

• 简单命令拼接仍可使用 {{.CLI_ARGS}}
• 参数遍历和处理可使用 {{range .CLI_ARGS_LIST}}
• 无需手动使用 splitArgs 函数进行字符串分割

实际应用示例

假设我们需要处理一个接受多个文件参数的任务：

version: '3'

tasks:
  process:
    desc: 处理多个文件
    cmds:
      - |
        {{range .CLI_ARGS_LIST}}
        echo "正在处理文件: {{.}}"
        # 这里可以添加实际处理逻辑
        {{end}}
      - |
        # 也可以一次性传递所有参数
        some_command {{.CLI_ARGS}}

这种改进使得 Taskfile 在参数处理方面更加符合现代开发者的预期，同时保持了与现有生态的兼容性，是工具演进过程中平衡创新与稳定的典范。