根本区别在于变量绑定时机：flag.string()返回新变量地址需解引用取值，flag.stringvar()直接绑定已有变量；flag.parse()必须在所有flag.xxx()之后调用，否则未注册参数无法解析；自定义类型须实现flag.value接口，否则运行时panic。
flag.String() 和 flag.StringVar() 的区别到底在哪
根本区别在于变量绑定时机：前者返回新变量地址，后者直接绑定已有变量。用错会导致参数解析失败但不报错，程序始终用默认值。
-
flag.String()返回*string，必须显式赋值给变量，比如port := flag.String("port", "8080", "")，后续要用*port取值 -
flag.StringVar()直接把解析结果写入你传入的变量，比如var port string; flag.StringVar(&port, "port", "8080", "")，之后直接用port - 新手常踩坑：混用两者，比如声明了
var port string却调用flag.String("port", ...)，导致port始终为空字符串 - 性能上无差异，但
StringVar更适合需要复用变量或提前初始化的场景（如配置结构体字段）
为什么 flag.Parse() 必须在所有 flag.Xxx() 之后调用
因为 flag.Parse() 会遍历内部注册的 flag 列表并从 os.Args[1:] 中匹配赋值；如果提前调用，后续定义的 flag 根本没被注册，自然不会被解析。
- 常见错误现象：命令行传了
-v，但flag.Bool("v", false, "")写在flag.Parse()后面 →v始终为false - 典型误写顺序：
flag.Parse(); flag.String(...); flag.Int(...)—— 这样所有参数都失效 - 正确姿势：所有
flag.Xxx()调用必须在flag.Parse()之前，且通常放在main()开头 - 如果参数定义分散（比如多个 init 函数），注意 Go 初始化顺序：包级变量 > init() > main()，确保
flag.Xxx()不在延迟执行的闭包里
自定义类型参数怎么让 flag 接受
要让 flag 支持任意类型，必须实现 flag.Value 接口（Set(string) error 和 String() string），否则编译不报错但运行时无法赋值。
- 错误示范：直接传 struct 指针给
flag.Var()，不实现接口 → 程序启动就 panic:flag provided but not defined - 正确做法：定义类型，实现
Set方法解析字符串（如逗号分隔转 slice），String返回当前值描述 - 示例：解析
-nodes a,b,c到[]string，需封装为type nodeList []string并实现接口 - 注意：实现
Set时别忽略错误处理，比如数字范围校验失败应返回fmt.Errorf(...)，否则用户输错也不会提示
flag 无法解析 --help 或 -h 的原因和修复
Go 的 flag 包默认支持 -h 和 --help，但前提是没手动注册同名 flag，且没调用 flag.Usage = nil 或覆盖 flag.Usage 时不调用原函数。
立即学习“go语言免费学习笔记（深入）”；
- 常见错误：写了
flag.Bool("h", false, "show help")→ 覆盖了内置 help，导致-h变成布尔开关，不再输出帮助 - 另一个坑：自定义
flag.Usage时只写了fmt.Println("my usage")，漏掉flag.PrintDefaults()→ 帮助里看不到参数说明 - 修复方式：避免用
h/help做自定义 flag 名；若必须，改用help-text这类长名 - 兼容性注意：Windows 下 cmd 默认把
--help当作无效参数，建议同时支持-h（flag 默认已做）
最易被忽略的是 flag 注册顺序和自定义 Value 的错误返回——不返回 error 就等于静默失败，用户输错参数却得不到任何提示，只能靠日志或调试器抓。
