Go命令行工具选型：小工具用flag，复杂多子命令用cobra；需修正Use名、提取Run逻辑、用PreRunE校验参数；静态编译注意DNS解析问题。
Go 语言写命令行工具，核心不是“怎么启动一个 main 函数”，而是「如何让参数解析不翻车、子命令不耦合、错误提示不裸奔、帮助信息不手写」。
用 flag 还是 spf13/cobra？看项目规模和维护预期
小工具（单命令、少于 3 个 flag、无子命令）直接用标准库 flag 更轻量；一旦涉及 git commit 那种多级子命令（mytool serve / mytool migrate up），spf13/cobra 是事实标准——它自动处理 help、completion、flag 继承、命令树遍历，省掉大量胶水代码。
-
flag适合：快速验证逻辑，比如./backup -src ./data -dst s3://bucket -
cobra适合：要长期维护、可能加权限校验/配置文件加载/日志分级的工具 - 别自己封装
flag解析器——cobra的cmd.Flags().StringVarP()已覆盖绝大多数需求
cobra init 后必须改的三处
执行 cobra init mytool 生成的骨架很干净，但默认配置容易踩坑：
-
rootCmd.Use默认是"mytool"，如果二进制名是mytool-cli，得同步改成"mytool-cli"，否则mytool-cli --help显示的用法还是mytool [flags] -
rootCmd.Run里别直接写业务逻辑，应提取成独立函数（如runRoot(cmd *cobra.Command, args []string)），方便单元测试 -
initConfig()默认只读$HOME/.mytool.yaml，若需支持.toml或当前目录config.toml，得在viper.SetConfigName("config")前调用viper.AddConfigPath(".")
参数校验别堆在 Run 里，用 PreRunE 拦截
用户输错参数时，应该在真正执行前报错退出，而不是等到打开文件/连数据库才吐 open xxx: no such file。用 PreRunE 可以集中做前置检查：
立即学习“go语言免费学习笔记（深入）”；
cmd.PreRunE = func(cmd *cobra.Command, args []string) error {
src, _ := cmd.Flags().GetString("src")
if src == "" {
return fmt.Errorf("--src is required")
}
if _, err := os.Stat(src); os.IsNotExist(err) {
return fmt.Errorf("--src path does not exist: %s", src)
}
return nil
}
- 返回
error会中断执行，自动打印错误并退出，不进入Run - 避免在
Run里重复写if src == ""判断——职责分离更清晰 - 注意：不要在
PreRunE里做耗时操作（如 HTTP 请求），会影响--help响应速度
交叉编译时，CGO_ENABLED=0 不是万能解药
想生成纯静态二进制发给用户，常加 CGO_ENABLED=0 go build，但它会禁用 DNS 解析（默认走 cgo 的 getaddrinfo），导致 http.Get("https://api.example.com") 失败。
- 解决方案一：保留
CGO_ENABLED=1，但用-ldflags '-extldflags "-static"'（仅 Linux 有效） - 解决方案二：强制 Go 使用纯 Go DNS 解析，在
main()开头加os.Setenv("GODEBUG", "netdns=go") - 验证是否真静态：
file ./mytool输出含statically linked，且ldd ./mytool报not a dynamic executable
CLI 工具最难的不是功能实现，而是让每个 flag 的含义明确、每个错误信息指向具体动作、每次 --help 都能让人立刻知道怎么用——这些细节全藏在 cobra 的钩子设计和错误包装方式里，而不是语法糖多寡。
