用go写命令行工具应首选cobra而非flag，初始化用cobra-cli init，子命令用cobra-cli add生成，参数通过cmd.flags()获取，错误处理统一用rune返回error，交叉编译前必须设cgo_enabled=0并用embed.fs打包资源。
用 Go 写命令行工具，别从 flag 开始硬刚——除非你确定只有一条命令、零子命令、不打算加 help 或自动补全。真实项目里，cobra 不是“可选增强”，而是避免踩坑的起点。
初始化项目必须用 cobra-cli init，不是 cobra init
旧文档里写的 cobra init 命令已废弃，当前最新版（v2+）要求先安装 CLI 工具：
go install github.com/spf13/cobra-cli@latest- 然后在空目录下运行
cobra-cli init
它会生成标准结构：main.go、cmd/root.go、cmd/ 子目录。注意：root.go 里的 var rootCmd = &cobra.Command{...} 是整个命令树的根，所有子命令都挂载到它下面；别手动改 Execute() 调用逻辑，更别把它挪进 main() 外部函数里。
加子命令必须用 cobra-cli add <name></name>，别手写注册
比如要加 learn-go fetch，直接运行：
cobra-cli add fetch
它会自动生成 cmd/fetch.go 并在 init() 函数里调用 rootCmd.AddCommand(fetchCmd)。手写注册容易漏掉这句，导致子命令不生效，且 cobra-cli 生成的模板已预置了 RunE 签名、错误返回和参数解析惯用法。
常见错误：
- 在
fetchCmd.Run里直接操作os.Args—— 应该用cmd.Flags().GetString("url")读参数 - 把全局 flag（如
--verbose）定义在子命令文件里 —— 应该统一在rootCmd.PersistentFlags()中声明 - 忘记给子命令设
Use字段（如"fetch"），导致learn-go fetch --help报错或显示空白
RunE 返回 error 才算真正落地，Run 容易掩盖失败
Run 函数里用 fmt.Println 或 log.Fatal 打印错误，程序就静默退出了，用户看不到具体报错原因，也没法做自动化判断。正确做法是全部迁移到 RunE：
RunE: func(cmd *cobra.Command, args []string) error {
url, _ := cmd.Flags().GetString("url")
if url == "" {
return fmt.Errorf("missing required flag: --url")
}
// 实际逻辑
return nil
}
这样 cobra 会自动把 error 输出到 stderr，并返回非零退出码。注意两点：
- 别在
RunE里调用os.Exit(1)或panic，否则 cobra 的错误处理链就断了 - 如果用了
viper绑定 flag，记得在rootCmd.PersistentPreRunE里调用viper.BindPFlag，否则 flag 值不会同步进配置
交叉编译前必须禁用 CGO，否则 Windows/macOS 二进制在 Linux 上跑不了
Go 默认启用 CGO，但命令行工具几乎不需要它。交叉编译时若不显式关闭，会链接宿主机的 libc，导致目标平台无法运行：
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o learn-go.exe .
顺手加上符号剥离和 UPX 压缩（如有）：
-
-ldflags="-s -w"：去掉调试符号和 DWARF 信息，减小体积 - 资源文件用
embed.FS打包进二进制，别依赖外部路径 —— 否则用户下载后一运行就报open examples/for_statement.go: no such file
最后检查：生成的二进制是否真的不含动态链接？用 file learn-go 看输出里有没有 “dynamically linked” —— 有就是 CGO 没关干净。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
