flag.parse()必须在所有flag定义之后、业务逻辑之前调用，否则标志值不会被覆盖；布尔标志支持-dubug和-debug=true等价，但-debug=false显式设为false；短选项与长选项需分别注册或共用变量；子命令须用flag.flagset隔离参数空间。
flag.Parse() 必须在所有 flag 定义之后、业务逻辑之前调用
很多新手写完 flag.String() 就直接开始用变量，结果发现值还是默认值——根本没被覆盖。这是因为 flag.Parse() 才真正触发解析动作，它会遍历 os.Args[1:] 并按规则填充已注册的标志。
常见错误现象：
- 变量始终是定义时的默认值，哪怕命令行明明传了
-port 9000 -
flag.Args()返回空切片，但实际有额外参数
正确顺序必须是：
- 先调用
flag.String()、flag.IntVar()等注册标志 - 再调用
flag.Parse() - 最后读取
*name或flag.Args()
一旦顺序错乱，比如把 flag.Parse() 放在某个 flag.Bool() 之前，那个布尔标志就完全不会被识别。
布尔标志 -debug 和 -debug=true 的行为差异
Go 的 flag 对布尔类型做了特殊处理：只要命令行出现 -debug（无论后面跟不跟 =true），值就为 true；不出现就是默认值。但如果你显式写成 -debug=false，它会被解析为 false —— 这和直觉相反，容易误判。
使用场景：
- 想开启调试：用
-debug或--debug - 想关闭调试（且默认是 true）：必须写
-debug=false，不能只省略该参数 - 避免歧义：不要同时支持
-d和--debug且默认值不同
注意：-debug false（空格分隔）在非布尔类型里合法，但对布尔类型无效——它会被忽略，-debug 仍为 true。
短选项 -v 和长选项 --verbose 共存需手动注册两个 flag
flag 包本身不自动绑定短/长选项，-v 和 --verbose 是两个独立标志，除非你显式用 flag.BoolVar() 分别注册。
参数差异：
-
flag.Bool("v", false, "verbose mode")→ 支持-v -
flag.Bool("verbose", false, "same as -v")→ 支持--verbose - 两者互不影响，可以同时传
-v --verbose，导致值被覆盖两次
更稳妥的做法是只注册一个，或用 flag.BoolVar() 绑定到同一变量指针，并确保 help 文本说明二者等价。
子命令场景下必须用 flag.FlagSet 隔离参数空间
像 git commit、docker build 这类带子命令的 CLI，不能靠单个全局 flag 包搞定。每个子命令的参数必须彼此隔离，否则 flag.Parse() 会把所有参数都扫一遍，造成冲突或静默失败。
实操关键点：
- 用
flag.NewFlagSet("commit", flag.ContinueOnError)创建独立解析器 - 子命令参数必须注册到这个新
FlagSet，而非全局flag - 调用
commitFlags.Parse(os.Args[2:])，注意切片起始位置 - 错误处理要自己捕获，
flag.ContinueOnError不会 panic
漏掉 FlagSet 隔离，会导致主命令参数被子命令误解析，或者子命令帮助信息混进主 help 里——这是最隐蔽也最难 debug 的问题之一。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
