flag.Parse()必须在所有flag定义之后调用，否则变量未绑定导致空值或panic；正确顺序为导入→声明注册→Parse→使用；flag.Args()截取首个非-flag参数及之后内容；自定义类型需实现flag.Value接口；环境变量需手动与flag协同，优先级为命令行＞环境变量＞flag默认值。
flag.Parse() 必须在所有 flag 定义之后调用
很多新手会在定义 flag.String 之前就调用 flag.Parse()，结果得到空值或 panic。Go 的 flag 包要求所有参数声明（如 flag.String、flag.Int）必须在 flag.Parse() 之前完成，否则这些变量不会被绑定到命令行输入上。
正确顺序是：
- 导入
"flag" - 声明变量并用
flag.String等注册 - 调用
flag.Parse() - 之后才能安全使用这些变量
常见错误现象：flag provided but not defined: -config 或变量始终为零值（如空字符串、0）。
如何区分 flag 和非 flag 参数（即 args）
flag.Parse() 会把命令行中第一个不以 - 或 -- 开头的参数及其之后的所有内容，截断并存入 flag.Args()；前面的带短横线参数则被解析进注册的 flag 变量。
立即学习“go语言免费学习笔记（深入）”；
例如执行：./app -v -c config.yml serve --port 8080
-
flag.Bool("v", false, "")→v为true -
flag.String("c", "", "")→c为"config.yml" -
flag.Args()返回[]string{"serve", "--port", "8080"}（注意--port没被解析，因未注册）
如果想支持子命令（如 serve、build），需手动处理 flag.Args()，不能依赖 flag 自动解析后续参数。
自定义类型需实现 flag.Value 接口
当需要解析复杂结构（如逗号分隔的字符串切片、自定义配置对象）时，不能直接用 flag.String，而要实现 flag.Value 接口的 Set(string) 和 String() 方法。
例如实现一个逗号分隔的字符串列表：
type stringSlice []string
func (s *stringSlice) Set(value string) error {
*s = strings.Split(value, ",")
return nil
}
func (s *stringSlice) String() string {
return strings.Join(*s, ",")
}
// 使用：
var tags stringSlice
flag.Var(&tags, "tags", "comma-separated list of tags")
漏掉 String() 会导致 flag.PrintDefaults() 输出异常；Set() 中没做错误检查可能掩盖解析失败。
默认值、环境变量和 flag 冲突怎么协调
flag 包本身不支持环境变量自动回退，也不提供默认值覆盖链（如 env → flag → hardcode）。你需要手动组合：
- 先读环境变量（如
os.Getenv("APP_PORT")） - 再定义 flag（如
flag.Int("port", 8080, "")），注意第二个参数是 flag 的默认值，不是最终默认值 - 调用
flag.Parse() - 最后按优先级赋值：命令行 > 环境变量 > flag 默认值
别写成 port := flag.Int("port", getEnvInt("APP_PORT", 8080), "") —— 这会让环境变量在 parse 前就被“固化”进 flag 默认值，失去运行时覆盖能力。
flag 解析逻辑简单直接，但和环境变量、配置文件混用时，控制权容易混乱。真正复杂的 CLI 工具建议换用 spf13/cobra，它原生支持多源优先级和子命令树。用原生 flag 时，边界得自己划清楚。
