flag.parse() 必须在所有 flag 定义之后调用，否则参数值保持零值；正确顺序是全部 flag.xxx() → flag.parse() → 使用变量；自定义类型需完整实现 flag.value 接口，短选项需显式注册，推荐使用 flag.stringvar 提升安全性和可维护性。
flag.Parse() 必须在所有 flag 定义之后调用
参数值永远是零值（空字符串、0、false），不是 bug，是执行顺序错了。Go 的 flag 包不自动读取 os.Args，flag.String() 这类调用只是“登记”参数，真正解析只发生在 flag.Parse() 执行时，且只处理此前已注册的 flag。
- 错误写法：
flag.Parse()放在main()第一行，后面再flag.String("port", "8080", "")—— 用户传-port 3000，*port仍是"8080" - 更隐蔽的坑：把
flag.Parse()写在init()函数里，而flag.String()在main()开头 ——init()执行时main()还没跑，注册根本没发生 - 正确顺序唯一：全部
flag.Xxx()或flag.XxxVar()→ 单次flag.Parse()→ 后续使用变量
自定义类型必须实现 flag.Value 接口
想支持 --ports 8080,3000,8443 或 --tags=a,b,c？直接用 flag.StringSlice 会失败，因为标准类型不识别逗号分隔语法。Go 只认实现了 flag.Value 接口的类型，缺一不可。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
-
Set(string) error：把命令行字符串转成你的目标类型，比如用strings.Split(value, ",")解析逗号列表 -
String() string：返回当前值的字符串表示，会被flag.PrintDefaults()打印到 help 里；返回空字符串会 panic - 常见错误：只实现
Set忘了String，或String返回""，运行时报 panic - 别用
flag.StringSlice试图“凑合”：它对-tags a -tags b只保留最后一个b，不是追加
短选项（-h）和长选项（--help）不能共用同一变量
flag 包不自动映射短选项，-h 和 --help 是两个完全独立的名字。只注册一个，另一个就会报 “unknown flag” 错误。
- 必须显式注册两个：
flag.BoolVar(&help, "h", false, "show help")和flag.BoolVar(&help, "help", false, "show help") - 别指望
flag.Bool("help", false, "")同时覆盖-h—— 它只响应--help - 注册后要主动检查：
if help { flag.Usage(); os.Exit(0) }，否则-h会触发默认 panic 退出 - 高频短选项（如
-v、-d）建议单独定义，并在业务逻辑里合并判断，比如if *verbose || *debug
flag.StringVar 比 flag.String 更适合生产代码
两者功能等价，但内存模型和可维护性差异大。flag.String() 返回新分配的指针，容易因提前解引用或忘记解引用出错；flag.StringVar() 直接绑定已有变量地址，规避指针生命周期管理。
-
flag.String("port", "8080", "")→ 得写*port取值，flag.Parse()前解引用会 panic -
flag.StringVar(&cfg.Port, "port", "8080", "")→ 后续直接用cfg.Port，无解引用负担，结构体字段初始化首选 - 编译器强制你传指针：
flag.StringVar(cfg.Port, ...)会直接报错cannot use cfg.Port (type string) as type *string，提早暴露问题 - 测试友好：单元测试中可快速 mock，
var testPort string; flag.StringVar(&testPort, "port", "", "")
flag.Value 类型时，Set 方法里没做空字符串过滤（比如 -tags=a,,b 导致切片含空项），以及子命令场景下误用全局 flag.Parse() 而不是独立 FlagSet 实例的 Parse()。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
