Go flag 包怎么支持重复参数：自定义 Value 的解析与默认值边界

命令行工具经常需要接收多个同名参数，例如连续传入 --tag=go 和 --tag=backend。Go 标准库 flag 的内置类型主要面向一个参数对应一个值；要保留重复出现的顺序，可以实现 flag.Value，让 Set 每被调用一次就追加一项。

重复参数的关键不是手动扫描 os.Args，而是把切片追加逻辑放进自定义 Value 的 Set 方法，再用 flag.Var 注册，最后调用 Parse 触发解析。

先把重复参数问题缩成一个小工具

我们做一个 tagcheck 命令：用户可以重复传入 --tag，程序按原顺序打印标签；如果一个标签都没传，则使用 default。这个边界足够小，能把注册、解析、验收串起来，也不会被业务代码掩盖。

package main

import (
    "flag"
    "fmt"
    "strings"
)

type stringList []string

func (s *stringList) String() string {
    return strings.Join(*s, ",")
}

func (s *stringList) Set(value string) error {
    if value == "" {
        return fmt.Errorf("tag cannot be empty")
    }
    *s = append(*s, value)
    return nil
}

func main() {
    var tags stringList
    flag.Var(&tags, "tag", "repeatable tag")
    flag.Parse()
    if len(tags) == 0 {
        tags = append(tags, "default")
    }
    fmt.Println(tags)
}

这里的调用链很短：flag.Var 把 tags 注册到解析器，Parse 读取命令行，遇到每个 --tag 就调用一次 Set。String 则由 flag 用于展示当前值，尤其是在帮助信息或调试输出中有用。

flag.Var、Parse 和 Set 各自负责什么

flag.Var 只做注册，不会提前解析

flag.Var(&tags, "tag", "repeatable tag") 把实现了 flag.Value 的对象交给解析器。注册时不会把命令行里的值塞进切片，因此此时 tags 仍然是空的。默认值可以在注册前初始化，但要想让“没有传参”保持可识别，通常让切片从空开始更清楚。

Parse 扫描参数，Set 处理一个值

执行 flag.Parse() 后，解析器按出现顺序处理参数。第一次出现 --tag=go 时调用 Set("go")，第二次出现 --tag=backend 时再次调用 Set("backend")，所以最终切片是 [go backend]，而不是后一个值覆盖前一个值。

默认值、空值和非法输入别混在一起

这三个状态在命令行工具里含义不同：未出现参数表示调用者没有选择；出现但值为空，可能表示调用者配置错误；值不符合业务规则，则应由 Set 返回可读错误。把默认值直接写进 stringList，会让程序无法区分前两种情况。

如果业务允许空标签，只需要删掉 Set 中的空字符串检查；如果标签还要限制长度或字符集，也应在 Set 内完成，这样每个入口都遵守同一条规则。不要等到 Parse 完成后再遍历切片补校验，否则错误位置和错误信息都会变模糊。

运行检查与集成边界

保存为 main.go 后，可以用下面两组输入核对顺序和默认值：

go run . --tag=go --tag=backend
[go backend]

go run .
[default]

集成到更大的命令行程序时，建议让 stringList 只负责参数语义，把去重、排序或标签查询留给后续业务层。这样重复参数的顺序仍然可用，业务若需要集合语义也能单独选择是否去重。

常见问题

为什么不用多个 stringVar？

多个 stringVar 只能预先决定参数个数，无法自然表达任意次数的同名参数；自定义 Value 更适合重复输入。

String 方法可以返回切片格式吗？

可以，但它主要用于显示当前值。解析动作仍然必须写在 Set 中，不能把字符串展示格式当成输入协议。

Set 返回错误后还会继续解析吗？

通常不会继续完成正常解析，flag 会把错误交给命令行错误处理流程。错误信息应指出哪个值不合法，方便用户修改参数。

验收结论

实现重复参数只需要三个关键动作：用 flag.Var 注册自定义 Value，用 Parse 启动解析，让 Set 每次追加一个值。默认值放在解析完成后的空切片判断里，空值与非法值则在 Set 中明确处理，这套边界在小工具和生产命令行程序里都容易测试。