多数简单工具用 flag 就够了，但需子命令、help、补全或版本管理时应选 cobra；交互输入要用 signal.Notify 捕获中断并清理缓冲；配置加载推荐 viper；静态资源嵌入用 embed 且注意路径大小写。
命令行参数解析用 flag 还是 cobra？
多数简单工具用 flag 就够了，但一旦需要子命令、自动 help、bash 补全或版本管理，flag 会迅速变得难维护。真实项目里，80% 的自定义 CLI 工具最终都迁到了 cobra —— 它不是“更高级”，而是把重复逻辑（比如参数绑定、错误提示格式、命令树构建）收口成可预测的模式。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 单命令小工具（如
mytool --config path.yaml start）：直接用flag，5 行就能跑通 - 带子命令的（如
mytool server start/mytool db migrate）：从第一天就用cobra，别等“以后再重构” -
cobra初始化后默认生成cmd/root.go和cmd/{sub}.go，别手动改main()入口，所有逻辑塞进RunE函数里 - 注意
cobra的PersistentFlags是全局生效的，比如--verbose放这里；而Flags只对当前命令有效
交互式输入怎么避免阻塞和信号中断？
用 fmt.Scanln 或 bufio.NewReader(os.Stdin).ReadString('\n') 在 Ctrl+C 场景下容易 panic 或残留输入缓冲，尤其在 cobra 命令中更明显。根本原因是没处理 os.Interrupt 信号，也没清理 stdin 状态。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 优先用
golang.org/x/term.ReadPassword处理密码类输入（它自动屏蔽回显并兼容 Windows） - 普通交互输入，用
bufio.NewReader(os.Stdin)+signal.Notify捕获os.Interrupt，并在 defer 中调用reader.Discard清空缓冲区 - 避免在
RunE中直接写交互逻辑；封装成独立函数，返回error而非os.Exit(1)，方便单元测试 - Windows 下
Ctrl+Z会触发 EOF，Linux/macOS 是Ctrl+D，统一提示时写成 “按 Ctrl+D（macOS/Linux）或 Ctrl+Z（Windows）结束输入”
如何让命令支持配置文件自动加载和覆盖优先级？
用户期望命令能自动读 ./config.yaml、$HOME/.mytool/config.yaml，同时允许通过 --config 显式指定，且命令行参数 > 配置文件 > 默认值。手写加载逻辑容易漏掉路径搜索顺序或 YAML/JSON 解析异常处理。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用
spf13/viper，它原生支持多格式、多路径、环境变量绑定和覆盖链 - 初始化时调用
viper.SetConfigName("config")、viper.AddConfigPath("./")、viper.AddConfigPath("$HOME/.mytool")，然后viper.ReadInConfig() - 命令行参数必须显式绑定：
rootCmd.Flags().String("output", "json", "output format")→viper.BindPFlag("output", rootCmd.Flags().Lookup("output")) - 别忽略
viper.Unmarshal(&cfg)的 error，YAML 缩进错误或字段类型不匹配时会静默失败，建议加if err != nil { return err }并打印原始错误
打包后命令找不到内置模板或静态资源？
Go 二进制是静态链接的，os.Open("templates/help.md") 在打包后必然失败 —— 文件没被打包进去。很多人卡在这一步，以为要改构建方式，其实 Go 1.16+ 的 embed 就是为这设计的。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 把模板文件放在
embed.FS变量里：var templates embed.FS，然后//go:embed templates/*.md注释紧贴上方 - 读取时用
templates.ReadFile("templates/help.md")，不是os.ReadFile -
embed不支持 glob 递归，子目录要显式列出：//go:embed templates/*/*.tmpl - 如果要用
text/template渲染，传入template.Must(template.New("").ParseFS(templates, "templates/*.md"))
嵌入资源这事，错一次就得重编译验证，别跳过测试环节。最常被忽略的是 embed 路径大小写 —— Linux 下 Templates 和 templates 是两个路径，但开发机 macOS 可能不报错，上线后突然失效。
