Go flag 怎样把重复参数解析为切片

我在给 Go 命令行工具加筛选条件时，经常会遇到这样的调用：tool -include=api -include=worker -include=cron。如果用 flag.String 接收，最后通常只得到一个字符串，继续手工拆分又会把参数格式、空值和错误处理混在业务代码里。

要让 flag 把多个同名参数收集成切片，最稳妥的做法是实现 flag.Value，在 Set(string) 中追加值，再通过 flag.Var 注册。 官方文档地址：https://pkg.go.dev/flag。这种方式能保留每次参数的边界，也能在值不合法时返回解析错误。

先比较四种接收方式

重复参数并不是把 flag.String 注册两次。相同名字的 flag 只能注册一次，但解析器可以在命令行中多次遇到这个名字。差别在于：每次遇到参数后，应该把值覆盖、拆分、立即消费，还是保存起来。

我的经验是：参数来自人手输入、值里可能出现逗号，或者调用方需要精确保留每次传入的边界时，直接选自定义 flag.Value。如果参数只是一个开关触发器，flag.Func 会更轻；如果输入本来就是一份复杂配置，继续堆叠重复参数反而不如配置文件或 JSON。

用 flag.Value 把每次出现的值追加到切片

flag.Value 的核心是两个方法：String 用于展示当前值，Set 用于接收解析器传入的字符串。把底层类型定义为 []string 后，Set 每被调用一次就追加一项，重复参数自然会变成切片。

package main

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

// stringList 保存每次出现的同名参数，不主动合并参数边界。
type stringList []string

// String 让 flag 在帮助信息和错误信息中能展示当前值。
func (s *stringList) String() string {
	if s == nil {
		return ""
	}
	return strings.Join(*s, ",")
}

// Set 接收一次 -include 的值；重复出现时会被重复调用。
func (s *stringList) Set(value string) error {
	value = strings.TrimSpace(value)
	if value == "" {
		// 空参数通常意味着调用方漏填值，直接返回解析错误。
		return fmt.Errorf("include 不能为空")
	}
	*s = append(*s, value)
	return nil
}

func main() {
	var includes stringList
	flag.Var(&includes, "include", "重复指定要处理的模块")
	flag.Parse()

	// 每个元素对应命令行中一次独立的 -include。
	fmt.Printf("includes=%q\\n", []string(includes))
}

运行时可以写成 -include=api -include=worker -include=cron，也可以使用非布尔 flag 支持的空格形式 -include api。解析器把三次输入分别传给 Set，最终切片顺序与参数出现顺序一致。

默认值、逗号和错误要先定规则

自定义类型最容易被忽略的地方不是 append，而是输入契约。要先回答三个问题：没有传参数时是否为空切片；一个值里是否允许逗号；空字符串是有意义的名字，还是应该报错。

如果确实希望支持 -include=api,worker，可以在 Set 中使用 strings.Split，但这表示逗号已经成为协议分隔符。不要一边把重复参数当独立值，一边又无条件拆分每个值，否则文件名、标签或表达式里的逗号会被悄悄改变。需要默认项时，可以在声明变量时初始化：

func main() {
	// 默认只处理 core；命令行参数出现后继续追加，而不是覆盖默认项。
	includes := stringList{"core"}

	fs := flag.NewFlagSet("modules", flag.ContinueOnError)
	fs.Var(&includes, "include", "重复指定模块")
	if err := fs.Parse([]string{"-include", "api", "-include=worker"}); err != nil {
		// ContinueOnError 让调用方拿到错误，适合测试和子命令。
		fmt.Println("parse error:", err)
		return
	}
	fmt.Printf("includes=%q\\n", []string(includes))
}

FlagSet 让测试或子命令拥有独立的参数集合，也避免修改全局 flag.CommandLine。如果默认值不应该和显式值同时存在，就不要在切片里预填，而是在第一次 Set 时清掉默认状态；这属于业务协议，应该在类型里明确表示。

什么时候换成 flag.Func 或配置文件

flag.Func 的思路是“看到一次就处理一次”。例如每个 -define key=value 都要立即校验并写入 map，回调会比自定义切片更直接。但如果解析完成后要在多个函数间读取一组有序值，回调仍然需要捕获切片，最终可读性未必更好。

重复参数适合短小、可重复、顺序有意义的输入，例如多个模块名或多个路径。参数超过几项、每项有嵌套结构，或者需要表达覆盖、删除和分组时，应该让 flag 只接收配置文件路径，再交给 JSON、YAML 或专门配置格式处理。命令行参数负责选择配置，配置文件负责承载结构，边界会更清楚。

常见问题

重复注册同名 flag 能不能得到切片？

不能。名称注册和参数出现次数是两件事。只注册一次自定义 Value，让同一个 Set 被多次调用，才是收集重复参数的入口。

为什么不用 strings.Split 直接解析一个长字符串？

逗号分隔会让值本身不能自然包含逗号，还需要定义连续逗号和空项的含义。若调用方能重复写参数，使用多个独立值更容易保留输入边界。

最终选择可以记成一句话：一个值用 flag.String，一次触发用 flag.Func，多个有序值用自定义 flag.Value，复杂结构则把命令行收敛为配置入口。这样重复参数解析不只是“能读到”，还把格式、错误和后续消费方式一起说明白了。