cobra-cli脚手架需先装git、在项目根目录执行go mod init、再运行cobra-cli init；否则main.go为空、rootCmd未注册、import路径错误，导致go run .报“no Go files in”或“command not found”。
cobra-cli 生成的脚手架不能直接跑起来，得先配好模块路径、补全 main.go、确保 rootCmd 正确注册——否则 go run . 会报 “no Go files in” 或 “command not found”。
执行 cobra-cli init 前必须完成三件事
很多人卡在第一步，不是 Cobra 不行，是初始化流程被跳过了：
- 先装
git并加入$PATH，cobra-cli init默认调用git config读作者信息，没git直接退出 - 在项目根目录（未来放
go.mod的地方）运行go mod init example.com/myapp，模块名不能是.或空 - 再执行
cobra-cli init，否则生成的cmd/root.goimport 路径错乱，main.go找不到rootCmd
cobra-cli add 添加子命令后不生效？检查这三点
常见现象：加了 serve 命令，但 myapp serve 报 unknown command "serve"：
- 确认
go.mod第一行是module example.com/myapp，否则cobra-cli add生成的import "example.com/myapp/cmd"会失效 - 检查
cmd/serve.go末尾是否含func init() { rootCmd.AddCommand(serveCmd) }；如果手动删过rootCmd变量，这行就白写了 - 别在
init()函数里做耗时操作（比如读配置），此时 flag 还没解析，cfgFile是空字符串，viper 会 panic
全局 flag（如 --config）为什么总不生效
注册位置错了。Cobra 的 flag 分三层作用域，写错就等于没写：
- 全局 flag 必须用
rootCmd.PersistentFlags().StringVarP(&cfgFile, "config", "c", "", "config file")，写在rootCmd.Flags()上只对 root 命令本身有效 - flag 解析逻辑不能放在
init()，得挪到rootCmd.PersistentPreRun回调里，用viper.SetConfigFile(cfgFile)加载 - 子命令若需覆盖某个 flag（比如
logs --tail），要用cmd.Flags().IntVarP(&tail, "tail", "t", 10, "lines to show")，别碰PersistentFlags，否则所有子命令都被污染
RunE 里怎么安全用 context 和依赖对象
微服务 CLI 的核心陷阱：依赖未初始化就调用，或 context 没传到底层。直接写 Run 函数大概率 panic：
立即学习“go语言免费学习笔记（深入）”；
- 所有初始化（viper 配置加载、logger、etcd client）必须放在
rootCmd.PreRunE，用cmd.Context()带超时控制，别在RunE里现场拉配置 - 子命令要取配置，用
cmd.Context().Value(configKey{})，别重复调viper.Unmarshal() - 信号处理（如
SIGTERM）不能靠cobra.Command自带机制——它不监听信号。得在serve.RunE里手动signal.Notify，配合http.Server.Shutdown()做优雅退出
health 命令查的是旧配置，serve 启动时 panic，status 返回空数据——表面是 Cobra 问题，实际是初始化时机和作用域没理清。 
