必须在testmain中用flag.commandline.parse(os.args[1:])早解析自定义flag，避免go test提前截获；不可在普通测试函数或init中调用flag.parse，且需统一收口声明以防重复注册。
go test 里怎么传自定义 Flag 参数
直接不行。go test 自带的 flag 解析器会提前截获并消费所有以 - 开头的参数，你定义的 flag.String() 等根本收不到。
常见错误现象是：程序里写了 flag.StringVar(&host, "host", "localhost", "")，运行 go test -host api.example.com 却报错 flag provided but not defined: -host —— 因为 go test 根本没把这参数转发给你的测试代码。
- 必须在
func TestMain(m *testing.M)中手动调用flag.Parse()，且要在os.Args被testing.M.Run()修改前完成 -
os.Args在TestMain入口时还保留原始命令行（含自定义 flag），但一旦调用m.Run()，它会被重写成只含go test自身识别的参数 - 别在普通测试函数里调用
flag.Parse()—— 此时os.Args已被清空或覆盖，解析必然失败
TestMain 中正确解析自定义 flag 的写法
核心就两点：早解析、早保存。不能依赖 flag.Parse() 自动处理全局 os.Args，得自己切分。
典型场景：想在集成测试中动态指定数据库地址或 mock 服务端口，又不想硬编码或靠环境变量。
立即学习“go语言免费学习笔记（深入）”；
- 在
TestMain开头立刻调用flag.CommandLine = flag.NewFlagSet(os.Args[0], flag.ContinueOnError)，避免污染默认 flag 集 - 用
flag.String("host", "localhost", "")等声明参数，但不要调用flag.Parse()—— 改用flag.CommandLine.Parse(os.Args[1:]) - 解析后立即读取值，比如
host := *flag.String("host", "localhost", "")不行，得先声明变量再绑定：var host string; flag.CommandLine.StringVar(&host, "host", "localhost", "") - 最后才调用
m.Run()，此时自定义参数已提取完毕，os.Args可被安全重写
示例片段：
func TestMain(m *testing.M) {
flag.CommandLine = flag.NewFlagSet(os.Args[0], flag.ContinueOnError)
var host string
flag.CommandLine.StringVar(&host, "host", "localhost", "test server host")
if err := flag.CommandLine.Parse(os.Args[1:]); err != nil {
log.Fatal(err)
}
// host 现在可用
os.Exit(m.Run())
}
为什么不用 -args 或 -test.arg 这类现成方案
因为它们不是标准 flag，而是 go test 内部私有机制，不经过 flag 包，无法和你自己的 flag 类型（如 flag.Duration、自定义 flag.Value）统一处理。
使用场景受限：比如你想支持 -timeout 30s 并自动转成 time.Duration，用 -args 就得自己 parse 字符串、容错、报错——白搭了标准库的类型安全。
-
go test -args -host example.com会把-host当作字符串塞进os.Args，但不会触发任何 flag 绑定逻辑 -
-test.arg是旧版遗留，Go 1.20+ 已弃用，且只支持单个键值对，没法扩展多个 flag - 如果你的测试要跑在 CI 或 Makefile 里，统一用
flag.CommandLine方式，参数格式和普通 Go 程序完全一致，运维更熟悉
容易踩的坑：flag 重复注册和并发冲突
多个测试文件都定义了同名 flag（比如都用了 flag.String("port", ...)），在同一个 go test 命令中运行时会 panic：flag redefined: port。
这不是 bug，是 flag 包的默认行为：所有包共享一个全局 flag.CommandLine，而 TestMain 又只能有一个。
- 解决办法：每个测试文件不要直接调用
flag.String，统一收口到主测试文件的TestMain里声明 - 如果项目大、模块多，建议把自定义 flag 提炼成独立配置结构体，用
json.Unmarshal+-config config.json替代一堆 flag —— 更易维护，也避开 flag 冲突 - 别在
init()函数里碰flag，测试包初始化顺序不可控，极易触发重复注册
真正麻烦的从来不是“怎么加参数”，而是“怎么让不同人写的测试不互相打架”。Flag 名字空间和解析时机，比语法本身重要得多。
