Go flag.Func 如何接收重复参数：默认值、解析顺序与错误退出

批处理命令常常需要重复接收同一种参数，例如连续写三次 -tag api -tag urgent -tag cn。如果把它们绑定到一个普通字符串变量，后面的值会覆盖前面的值；flag.Func 的用途正是让每次出现的参数都进入同一个回调，按出现顺序追加或校验。

flag.Func 的回调只在参数被实际传入时调用，重复参数会按解析顺序多次触发；默认值不会自动调用回调，而回调返回 error 会让 Parse 失败。

先看重复参数为什么会覆盖

普通的 flag.String 适合一个选项对应一个最终值，但它的写入语义是“后一次赋值覆盖前一次”。批处理工具如果要保留多个标签、多个输入文件或多组筛选条件，就需要把“解析一次”变成“追加一次”。

flag.Func 注册一个带参数的 flag 和一个回调 Fn。解析器每次调用 Set 时都会把本次参数值交给 Fn，所以 tags 可以稳定保留原始顺序：

package main

import (
    "flag"
    "fmt"
)

func main() {
    var tags []string
    flag.Func("tag", "重复指定标签", func(value string) error {
        if value == "" {
            return fmt.Errorf("tag 不能为空")
        }
        tags = append(tags, value)
        return nil
    })

    flag.Parse()
    fmt.Println("tags:", tags)
}

执行 go run . -tag api -tag urgent -tag cn 后，Fn 依次收到 api、urgent、cn，最终切片仍是这个顺序。这里的关键不是切片本身，而是 Set 每次都把一个值交给同一个回调。

默认值和重复值要分开设计

flag.Func 与 flag.String 不同，它不会替你保存一个 default value。程序启动时如果希望没有 -tag 时仍有默认标签，应在解析前初始化切片或用一个布尔值记录用户是否传过参数。

tags := []string{"default"}
provided := false

flag.Func("tag", "重复指定标签", func(value string) error {
    if value == "" {
        return fmt.Errorf("tag 不能为空")
    }
    if !provided {
        tags = nil
        provided = true
    }
    tags = append(tags, value)
    return nil
})

这个写法表达的是“用户一旦显式传入标签，就用显式值替换默认值”。如果你的产品语义是默认值和命令行值都保留，就不要清空 tags；先确定语义，再决定回调里的第一笔写入动作。

Parse、error 与 Args 的边界

回调返回非 nil error 时，Parse 会把它当成参数值解析失败。下面的程序使用独立的 FlagSet，方便测试错误而不污染全局 flag：

fs := flag.NewFlagSet("labels", flag.ContinueOnError)
var tags []string
fs.Func("tag", "重复指定标签", func(value string) error {
    if value == "" {
        return fmt.Errorf("tag 不能为空")
    }
    tags = append(tags, value)
    return nil
})

err := fs.Parse([]string{"-tag", "api", "input.json"})
fmt.Println("error:", err)
fmt.Println("tags:", tags)
fmt.Println("args:", fs.Args())

这次 Parse 会先处理 -tag api，遇到 input.json 后停止继续识别 flag；它不会把这个文件名交给 Fn，而是把它放在 Args 中。相反，如果参数是 -tag ""，回调会返回 error，调用方必须检查 err 后决定是否退出。

三个容易踩到的误区

把回调当成一次性初始化函数

Fn 的调用次数取决于用户写了几次参数。需要一次性读取完整列表时，可以在回调中追加；不要在回调外假定它只执行一次。

把空字符串当成“没有传参数”

参数 -tag "" 是用户确实传了一个空值。是否允许它应该由回调明确校验，而不是让空值悄悄进入业务切片。

Parse 出错后继续跑主流程

如果 error 非 nil，标签列表可能只收到了前半段参数。继续生成文件或发起请求，会把一个不完整配置伪装成正常输入。

什么时候应该用 flag.Func

当参数结构是“同一个名字可以出现多次，每次值都要独立校验或转换”时，flag.Func 很合适。它让回调承担单值校验，让外层切片、map 或配置对象承担聚合；如果参数只有一个最终值，普通的 String、Int 反而更直白。

上线前可以按这条顺序验收：重复传入两到三个值，确认 Fn 顺序；不传参数，确认默认策略；传入非法值，确认 Parse 返回 error；最后再传入一个位置参数，确认它出现在 Args 而不是标签列表中。

相关问题

flag.Func 能不能接收没有值的开关？

不能。flag.Func 定义的是带字符串值的 flag；不需要参数的开关应考虑 Bool 或 Go 1.21 引入的 BoolFunc。

回调返回 error 后还会继续处理后面的参数吗？

不应依赖继续处理。Parse 会把它视作解析错误，调用方应立即检查返回值并停止主流程。

位置参数能和重复 flag 交错吗？

标准库 flag 在遇到第一个非 flag 参数后停止解析，后续内容会进入 Args；需要更复杂的子命令语法时应换用更适合的解析器。

把回调边界留在解析层

flag.Func 最有价值的地方是把“一个参数值是否合法”与“多个值如何组合”拆开。回调只处理当前值并返回明确错误，Parse 负责顺序和失败边界，业务层再消费完成的 tags 与 Args。这样重复参数、默认值和非法输入三种情况不会挤在一个模糊的字符串变量里。