Go flag 默认 help 简陋，需自定义 flag.Usage 函数并在 flag.Parse() 前设置，用 text/tabwriter 对齐参数名、类型、默认值和说明，注意子命令需单独设 fs.Usage，多命令场景建议换用 cobra。
flag 包默认 help 输出太简陋，怎么让它自动带参数说明
Go 标准库 flag 默认的 -h 或 --help 只打印一行用法和空行，不显示每个 flag 的用途。这不是 bug，是设计如此——它把「描述文本」和「帮助格式化」完全解耦了。
真正起作用的是 flag.Usage 这个全局变量，它是个函数类型：func()。只要在 flag.Parse() 之前给它赋一个自定义函数，就能控制整个 help 输出内容。
- 别在
flag.Parse()之后改flag.Usage，没用 - 别直接 print 到 stdout；应该写到
flag.CommandLine.Output()，否则重定向时 help 会消失 - 所有 flag 的说明文字，得手动传给
flag.String()等函数的第三个参数，比如flag.String("port", "8080", "HTTP server port")
怎么让 help 按照「参数名 + 类型 + 默认值 + 说明」对齐排版
标准 flag.PrintDefaults() 能输出带缩进的格式，但它只打印已定义的 flag，且不包含命令名、全局说明或示例。想整齐对齐，得自己拼接字段宽度。
关键不是“生成”，而是“控制列宽”。Go 没有内置对齐工具，但可以用 fmt.Printf 的宽度占位符（如 %-20s）手动对齐，或者用 text/tabwriter 包做更稳的表格对齐。
立即学习“go语言免费学习笔记（深入）”；
-
text/tabwriter是官方推荐方案，能自动处理多行说明换行和列宽计算 - 别用字符串拼接加空格对齐，终端字体不等宽时会错位
- 默认值要从 flag.Value 的
String()方法取，不是硬编码；比如flag.Int("timeout", 30, "request timeout in seconds")的默认值是"30"，但用户可能改过，应调用flag.Lookup("timeout").Value.String()
为什么自定义 Usage 后 -h 不生效，或者 help 里看不到子命令
常见原因是用了第三方命令行库（比如 spf13/cobra），而误以为还在用原生 flag。Cobra 自己管 help，flag.Usage 完全不生效。
另一个坑是：多个 flag set 并存时（比如自定义 flag.NewFlagSet），你改的是全局 flag.Usage，但实际调用的是子集的 fs.Usage，必须单独设置。
- 检查是否 import 了
cobra或urfave/cli；有就别碰flag.Usage，看对应库的SetHelpTemplate或HelpPrinter - 如果用了子命令，每个子命令的
FlagSet都要单独设fs.Usage = func() { ... } - 错误信息
flag: help requested是正常退出信号，不是 panic，别用 recover 捕获
要不要用第三方库替代 flag？什么时候该换
如果只需要单命令、无子命令、参数少于 5 个，原生 flag 加自定义 Usage 完全够用，零依赖、启动快、逻辑透明。
一旦出现以下任一情况，就该考虑 cobra：subcommand、bash completion、version flag 自动生成、需要嵌套 help（比如 mytool serve -h 和 mytool -h 不同）。
-
cobra的 help 模板是 Go template，可定制但学习成本略高；它的Example字段不会自动渲染，得手写进Long里 - 别为了“好看”换库；
flag配tabwriter也能输出专业级 help，只是多写 15 行代码 - 注意
cobra默认开启completion和help命令，若不想暴露，得显式关掉：rootCmd.CompletionOptions.DisableDefaultCmd = true
最常被忽略的一点：help 文本里的路径或命令示例，比如 myapp -c config.yaml，里面的 myapp 应该用 os.Args[0] 动态获取，而不是硬写死——用户可能用软链接或 alias 调用，名字未必是源文件名。
