flag.String 返回指针是为了在解析命令行时能将用户输入写入内存指定位置；若返回值则无法更新，常见错误是未解引用导致打印内存地址。
flag.String 为什么返回的是指针而不是值
因为 flag.String 需要让 flag 包在解析命令行时，把用户输入的字符串写进内存某个位置——它得知道写哪儿。返回指针就是告诉调用方：“你拿这个地址去读，我后面会往里填”。如果你直接要值，flag 就没法在解析阶段更新它。
常见错误现象：flag.String("name", "default", "") 返回的是 *string，但有人直接当 string 用，比如传给 fmt.Println 时不加 *，结果打出来是内存地址（类似 0xc000010230）。
- 正确用法：先声明变量接收指针，再解引用：
name := flag.String("name", "default", ""); fmt.Println(*name) - 也可以用
flag.StringVar配合已有变量，避免手动解引用：var name string; flag.StringVar(&name, "name", "default", "") - 所有
flag.Xxx（如Int、Bool）都返回指针；StringVar、IntVar等才接受地址并原地赋值
flag.Parse() 必须在所有 flag 声明之后、业务逻辑之前调用
flag.Parse() 不是“初始化 flag”，而是“开始扫描 os.Args 并填充之前注册的所有 flag 变量”。它一执行，os.Args 就被截断——只留下未被 flag 消费的剩余参数（存进 flag.Args()）。如果调得太早，后续声明的 flag 根本不会被识别；如果调得太晚，可能已经误用了未解析的参数。
使用场景：写 CLI 工具时，典型顺序是「声明 flag → 调用 flag.Parse() → 检查 flag.Args() 或 flag 值 → 执行主逻辑」。
- 错误示例：在
flag.String之前就调flag.Parse()，会导致该 flag 总是用默认值，且不报错 - 性能影响：
flag.Parse()是一次性遍历，开销极小；但反复调用（比如在循环里）会 panic，因为内部状态已标记为“已解析” - 兼容性注意：Go 1.20+ 对重复 flag 的处理更严格，多次注册同名 flag 会直接 panic，不是静默覆盖
如何支持 --help 和自定义用法提示
flag 包默认支持 -h 和 --help，但前提是没禁用，且没重定义这两个 flag。一旦你手动声明了 flag.Bool("help", false, "...")，默认帮助逻辑就失效了——它只会按普通 bool 处理，不会自动打印 Usage。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
常见错误现象：加了 --help 却没输出帮助信息，或者输出后程序继续往下跑（比如连数据库），而不是退出。
- 正确做法：别自己声明
help，让 flag 包自己管；它会在检测到 help 后调用flag.Usage()并 exit(0) - 自定义提示：覆写
flag.Usage = func() { fmt.Fprintf(os.Stderr, "Usage: %s [flags]\n", os.Args[0]); flag.PrintDefaults() } - 如果需要在 help 后做清理（比如关闭日志句柄），不能靠 defer——因为
flag.Usage内部直接调os.Exit(0)，defer 不会执行
flag 无法解析带空格的字符串参数？其实是 shell 问题
flag 本身完全支持含空格的参数，比如 ./app -msg "hello world"。问题往往出在 shell 层没把引号传进去，或者用户漏写了引号，导致空格被当成参数分隔符。
错误现象：./app -msg hello world 实际上传了两个参数：-msg 和 hello，world 成了 flag.Args() 的第一个元素，而 msg 得到的是 "hello"（默认值或空）。
- 验证方法：在程序开头加
fmt.Printf("Args: %q\n", os.Args)，看 shell 真正传进来的是什么 - 解决方案：要求用户用单引号或双引号包裹；服务端 CLI 可以用
flag.Arg(i)拼接剩余参数，但需明确文档说明 - 注意：Windows cmd 对引号处理和 bash 不同，双引号内反斜杠可能被转义，测试时得覆盖实际运行环境
事情说清了就结束。最常卡住人的点其实就两个：一是忘了 flag.Parse() 的时机，二是把指针当值用还硬 debug 半天。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
