Go命令行工具核心是避免flag解析错误、子命令耦合、错误裸奔和跨平台编译踩坑：flag需在Parse前注册且传正确指针；子命令用NewFlagSet隔离；单命令优选原生flag，复杂场景选cobra但慎用隐式Exit；路径处理用filepath.FromSlash和Abs；跨平台编译须禁用cgo或用docker构建。
Go 语言写命令行工具，核心不是“怎么搭架子”，而是「如何让 flag 解析不翻车、子命令不耦合、错误输出不裸奔、跨平台编译不踩坑」。
flag.Parse() 为什么总在 main() 开头就 panic？
常见现象：flag.Parse() 报 flag provided but not defined，尤其加了自定义 flag.Usage 或用了 flag.StringVar 却漏传指针。
- 必须确保所有
flag.String()/flag.Int()等调用都在flag.Parse()之前，且变量地址正确（flag.StringVar(&dst, "name", "", "")中&dst不能是字面量或临时值） - 如果提前调用
log.Fatal()或os.Exit(1)，会跳过flag.Parse()的内部清理，导致后续多次调用出错——建议统一用os.Exit()收尾，别混用log.Fatal - 子命令场景下，不要在根命令里
flag.Parse()后再手动解析子命令参数；改用flag.NewFlagSet为每个子命令建独立解析器
用 cobra 还是原生 flag？看这三点再决定
不是“高级就选 cobra”，而是看项目是否需要：自动 help 输出、嵌套子命令（如 git commit -m）、bash/zsh 补全、参数验证钩子。
- 纯单命令工具（比如一个
jsonfmt），用原生flag更轻量，二进制体积小 200KB+，启动快 1–2ms - 要支持
mytool serve --port=8080+mytool migrate up，cobra 是事实标准，但注意：它的cmd.Execute()会隐式调用os.Exit()，别在外层再包一层os.Exit(cmd.Execute())，否则退出码永远是 0 - 如果选 cobra，禁用它自带的
version命令（rootCmd.Version = ""），自己用runtime/debug.ReadBuildInfo()提取vcs.revision，避免构建时没设-ldflags="-X main.version=..."导致 version 字段为空
命令行参数里的路径和文件名，为什么 Windows 上总报 invalid argument？
本质是 Go 的 os.Open() 和 filepath.Join() 在不同系统对反斜杠、空格、UNC 路径处理不一致。
立即学习“go语言免费学习笔记（深入）”；
- 永远用
filepath.FromSlash()处理用户输入的路径字符串（尤其从 flag 获取后），把/统一转成当前系统分隔符 - 读取文件前，先用
filepath.Abs()归一化路径，再检查os.Stat()是否返回nil；别直接拼接字符串后os.Open("config/" + args.Config) - Windows 下命令行传带空格路径（如
mytool -f "C:\My Files\conf.json"），shell 已经做了引号剥离，Go 拿到的就是干净字符串，无需额外去引号——但如果你用exec.Command调外部程序，就得手动用strconv.Quote()包裹参数
交叉编译的二进制为什么在 Linux 上运行报 no such file or directory？
不是文件真丢了，而是动态链接器路径不匹配。Go 默认用 CGO_ENABLED=1 编译时依赖系统 libc，跨发行版容易崩。
- 发布 CLI 工具务必关闭 cgo：
CGO_ENABLED=0 go build -o mytool .，生成静态链接二进制，能跑在 Alpine、BusyBox 等最小化系统 - macOS 上编译 Linux 版本，需显式指定目标 GOOS/GOARCH：
GOOS=linux GOARCH=amd64 go build -o mytool-linux .；别依赖本地环境自动推断 - 如果工具内部调用了
cgo（比如 SQLite 或 OpenSSL），那就必须保留CGO_ENABLED=1，此时要搭配docker buildx或虚拟机做真实目标环境编译，静态链接不再可行
CLI 工具最麻烦的从来不是功能实现，而是参数边界校验、错误提示语义化、以及构建产物在各种终端里不吐奇怪的 ANSI 序列——尤其当用户把你的二进制拖进 tmux 或旧版 PowerShell 时。
