flag.parse()必须在所有flag.xxx()之后调用，否则后续声明的flag无法被解析；子命令需各自调用newflagset().parse()；-h与--help需分别注册；stringvar适合结构体字段，string适合快速脚本；切片解析需自定义flag.value实现。
flag.Parse() 必须放在所有 flag.Xxx() 之后
这是最常踩的坑：提前调用 flag.Parse()，结果所有参数都拿不到值。因为 flag.Parse() 只解析**此前已注册**的 flag，后续声明的变量根本不会被识别——*name 永远是空字符串，*age 永远是 0。
- 错误写法：
flag.Parse()写在第一行，再调用flag.String() - 正确顺序：先声明所有
flag.String()、flag.Int()等，最后统一调用一次flag.Parse() - 如果用了多个
flag.NewFlagSet()（比如子命令），每个 set 都要单独调用自己的.Parse()，不能复用全局flag.Parse()
短选项（-h）和长选项（--help）不自动共存
Go 的 flag 包默认只认 --help，-h 直接报错“unknown flag”。它不会像 bash 或其他 CLI 工具那样自动映射单字符缩写。
- 必须显式注册两个独立 flag：
flag.Bool("h", false, "show help")和flag.Bool("help", false, "show help") - 别指望
-h和--help共享同一个变量——它们就是两个不同名字的 flag，得分别绑定或手动同步逻辑 - 如果想统一处理，建议在
flag.Parse()后检查：if *help || *h { printUsage(); os.Exit(0) }
StringVar 和 String 的选择取决于变量生命周期
flag.String() 返回 *string，适合快速脚本；flag.StringVar() 绑定已有变量地址，更适合结构体字段或需复用变量名的场景。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 用
flag.String()：适合简单命令行工具，变量不用长期持有，直接解引用即可，例如：host := flag.String("host", "localhost", "")→ 后续用*host - 用
flag.StringVar()：适合配置结构体，避免指针管理负担，例如：var cfg struct{ Host string }; flag.StringVar(&cfg.Host, "host", "localhost", "")→ 后续直接用cfg.Host - 传给
StringVar的必须是指针，写成flag.StringVar(cfg.Host, ...)会编译报错：cannot use cfg.Host (type string) as type *string
解析切片或 CSV 列表必须实现 flag.Value
flag 原生不支持 -tags=a,b,c 这种逗号分隔的字符串转切片，也不支持多次 -file a.txt -file b.txt 自动聚合——这些都得靠自定义 flag.Value。
- 核心是实现两个方法：
Set(string) error和String() string - 容易漏掉空字符串处理：比如
-tags=a,,b会生成[]string{"a", "", "b"}，应在Set里加strings.TrimSpace和过滤空项 - 若需支持多次传参（如多个
-file），Set方法里要用append，而不是直接赋值；否则只有最后一次生效
最麻烦的其实是子命令分发和帮助文本定制——flag 不提供开箱即用的嵌套解析，也不允许改写默认 -h 输出。这些地方一旦忽略，用户第一次运行就卡在报错或看不懂的帮助页上。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
