必须显式桥接 flag 与 pflag、用 *P 函数定义短名、改用 pflag.Args() 取剩余参数，否则参数静默失效；混用时需调用 AddGoFlagSet，且顺序为：定义 flag → 桥接 → pflag.Parse()。
能直接替换标准 flag，但必须显式桥接、用 *P 函数定义短名、改用 pflag.Args() 取剩余参数，否则参数静默失效。
混用 flag 和 pflag 时必须调用 AddGoFlagSet
如果你项目里已有大量 flag.String 调用（比如依赖 klog、test 包等），又想统一用 pflag.Parse() 解析，就不能只改 import。漏掉桥接，所有原 flag 定义的参数（如 -v、-test.v）会被完全忽略，且不报错。
- 必须在
pflag.Parse()之前执行：pflag.CommandLine.AddGoFlagSet(flag.CommandLine) - 顺序不能错：先定义所有
flag参数（包括依赖库 init 里注册的），再桥接，最后pflag.Parse() - 若你用的是自定义
flag.FlagSet（非全局flag.CommandLine），需显式传入该实例，而非flag.CommandLine
StringP、BoolVarP 才支持 POSIX 短选项
pflag 不像 flag 默认支持 -h 这类写法。短名必须用带 P 后缀的函数显式声明，且短名只能是单字符，不带 - 或 --。
- 正确：
pflag.StringP("output", "o", "text", "output format")→ 支持--output json和-o json - 错误：
pflag.StringP("output", "-o", ...)或pflag.StringP("output", "--o", ...)会 panic：duplicate short flag - 两个
StringP若短名都设为"o"，程序启动即 panic，不是解析时报错 - 不需要短选项时，用
String/BoolVar更安全，避免冲突
取位置参数必须用 pflag.Args()，不是 flag.Args()
很多旧代码习惯写 flag.Args()[0] 拿子命令或文件路径，换成 pflag 后若不改，会 panic 或拿到空切片 —— 因为 pflag 把未识别参数存在自己内部，和 flag 完全隔离。
立即学习“go语言免费学习笔记（深入）”；
-
pflag.Parse()后，用pflag.Args()获取剩余参数，不是flag.Args() - 如果命令要支持子命令（如
mycmd serve --port 8080），需手动切分pflag.Args()，再对子命令部分新建pflag.FlagSet解析 -
pflag.CommandLine.UnquoteArgs = false可禁用默认的--截断行为（例如cmd -- -a -b中的-a默认当字符串，设为false后会尝试继续解析）
POSIX 兼容不是开箱即得，而是靠这三处显式选择：桥接、*P 函数、pflag.Args()。少一个，参数就可能“看起来正常，实际不生效”。
