直接用cobra init失败是因为依赖git且未提前go mod init；需先装git并加入path、在项目根目录执行go mod init，再运行cobra init，否则main.go为空、root命令未注册、import路径错误。
为什么直接用 cobra init 会失败或生成不完整结构
多数人执行 cobra init 后发现根命令没注册、main.go 空着、甚至报错 failed to create root command: exec: "git": executable file not found in $PATH。这不是 Cobra 本身的问题，而是它默认依赖 git 初始化项目元信息（比如作者、license），且要求当前目录是 git 仓库根目录。
- 确保已安装
git并在$PATH中，否则cobra init直接退出 - 必须在项目根目录（即未来
go.mod所在位置）运行，否则生成的cmd/root.go无法被main.go正确导入 -
cobra init不会自动创建go.mod，得先手动go mod init example.com/myapp
如何让 cobra add 正确添加子命令并避免 import 冲突
执行 cobra add serve 后，常出现 cannot find package "github.com/spf13/cobra" 或新命令没出现在 rootCmd.AddCommand 列表里——根本原因是 Cobra 默认按模块路径生成 import 路径，但没校验本地模块名是否匹配。
- 运行
cobra add前，确认go.mod第一行是module example.com/myapp（不能是.或空） - 检查生成的
cmd/serve.go，顶部import是否指向你的模块路径，例如：import "example.com/myapp/cmd"，而非硬编码的"github.com/xxx/yyy/cmd" -
cobra add生成的init()函数会自动调用rootCmd.AddCommand(serveCmd)，但只在cmd/root.go已存在该变量的前提下生效；若你删过或重命名过rootCmd，需手动补上
怎么定制 root 命令参数和全局 flag 而不破坏 Cobra 自动绑定
Cobra 默认把 --help 和 --version 绑定到 root，但如果你在 init() 里提前调用 rootCmd.PersistentFlags().StringVarP(&cfgFile, "config", "c", "", "config file")，却忘了在 preRun 或 run 阶段解析，就会导致 flag 看似注册了却没生效。
- 全局 flag 必须在
rootCmd.PersistentFlags()上注册，而非rootCmd.Flags()（后者仅对 root 本身有效） - 配置文件路径解析建议放在
rootCmd.PersistentPreRun回调里，用viper.SetConfigFile(cfgFile)，避免子命令重复初始化 - 别在
init()里做 heavy 初始化（如读配置、连 DB），Cobra 的init()是包加载时触发，此时 flag 还未 parse，cfgFile仍是空字符串
为什么 go run . 报错 no Go files in ... 或找不到 main 函数
生成脚手架后直接 go run . 失败，通常是因为 main.go 没被正确创建，或者 cmd 包没被引用。Cobra 的 cobra init 只生成 cmd/root.go 和 main.go 模板，但某些旧版本或非标准安装方式会导致 main.go 缺失或内容为空。
- 手动创建
main.go（如果不存在），内容只需两行：package main和func main() { cmd.Execute() } - 确保
main.go里 import 了你的命令包，例如：import "example.com/myapp/cmd"，且调用的是cmd.Execute()而非root.Execute() - 运行前先
go mod tidy，Cobra 依赖github.com/spf13/cobra和github.com/spf13/pflag，缺一不可
go mod init 先做、main.go 手动补全、所有 import 路径和模块名严格一致。剩下就是改 cmd/root.go 里的 Short/Long 字段和加业务逻辑了。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
