flag.string 和 flag.stringslice 行为不同：前者仅存最后一个值，后者支持多值；自定义 flag.value 必须同时实现 set 和 string 方法；flag.parse() 必须在所有 flag 定义之后调用。
flag.String 和 flag.StringSlice 用错会导致 panic
Go 的 flag 包里，String 和 StringSlice 看似都能接收字符串参数，但行为完全不同：前者只接受单个值，后者才支持多次出现的同名标志（比如 -v -v -v）。如果误用 flag.String 却传入多个 -v，程序不会报错，但后续调用 flag.Parse() 后，只会保留最后一个值，前面的全丢——而且没有任何提示。
常见错误现象：-log-level debug -log-level info 最终读到的却是 info，而你根本没意识到。
- 定义多值参数必须用
flag.StringSlice("log-level", []string{}, "set log level") - 单值参数用
flag.String("config", "config.yaml", "config file path") - 注意默认值类型要匹配：给
StringSlice传nil或空切片[]string{}都可以，但不能传"" - 解析后记得调用
flag.Parse()，否则所有标志位都是零值
自定义 flag.Value 接口时忘记实现 Set 方法
想支持类似 -timeout 30s 这种带单位的参数？得自己实现 flag.Value 接口。但很多人只写了 String() 方法，漏掉 Set(string)——结果运行时报 panic: invalid value "30s" for flag -timeout: interface conversion: flag.Value is *main.timeoutFlag, not *flag.stringValue。
原因在于 flag 内部靠 Set() 赋值，String() 只用于打印帮助信息。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 必须同时实现两个方法：
func (f *timeoutFlag) Set(s string) error和func (f *timeoutFlag) String() string -
Set()返回error表示解析失败，此时flag.Parse()会自动退出并打印错误 - 别在
Set()里 panic，flag 机制不捕获 panic，直接崩
flag.Parse() 必须在所有 flag 定义之后、业务逻辑之前调用
顺序错了，所有标志位都读不到。比如把 flag.Parse() 放在 flag.String() 前面，或者夹在中间，变量永远是零值；更隐蔽的是，在 init() 函数里提前调用了 flag.Parse()，导致 main() 里定义的 flag 根本没注册上。
典型场景：写了个工具，本地测试没问题，CI 上却始终用默认配置——因为 CI 脚本里加了额外 flag，而你的 Parse() 调得太早，没覆盖到。
- 所有
flag.Xxx()调用必须出现在flag.Parse()之前 - 不要在包级变量初始化或
init()中调用flag.Parse() - 如果要用非
os.Args的参数（比如测试用的字符串切片），得用flag.NewFlagSet()手动创建新集合并调用其Parse()
子命令场景下 flag.Arg(0) 不可靠，该用 flag.Args()
写 CLI 工具常需要支持子命令，比如 mytool serve --port 8080。这时候有人习惯用 flag.Arg(0) 拿子命令名，但一旦用户忘了加 -- 分隔符，或者 flag 解析出错，Arg(0) 就可能返回空或错位的值。
根本原因是 flag.Arg(i) 是对 flag.Args() 切片的封装，而 flag.Args() 返回的是“未被 flag 解析的剩余参数”——它依赖 Parse() 正确执行完。
- 子命令识别应基于
flag.Args()，而不是flag.Arg(0) - 若需严格区分 flag 和子命令，推荐用
flag.NewFlagSet()为每个子命令单独建解析器 - 别假设
Args()至少有一个元素，先判空再取[0]
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
