子命令不生效的根本原因是未将子命令显式挂载到其直接父级的commands字段，cobra不会自动递归遍历嵌套结构；必须逐级调用addcommand，如usercmd.addcommand(createcmd)后再rootcmd.addcommand(usercmd)，且use值须为纯单词、run不可为nil、需调用execute()启动解析。
子命令不生效：AddCommand调用后仍报 unknown command
根本原因不是漏注册，而是没把子命令真正挂到命令树上。Cobra 的 AddCommand 只是往内部 Commands slice 追加，但解析器不会自动递归遍历嵌套结构——必须确保每个子命令都显式添加到其**直接父级**的 Commands 字段中。
常见错误现象：go run main.go user create 报错 unknown command "create" for "myapp"，但 userCmd.AddCommand(createCmd) 确实写了。
-
createCmd必须先挂到userCmd上：userCmd.AddCommand(createCmd) -
userCmd必须再挂到rootCmd上：rootCmd.AddCommand(userCmd)，缺一不可 -
createCmd.Use值只能是纯单词（如"create"），不能含空格、斜杠或短横线前缀 - 所有子命令的
Run字段不能为nil，否则启动时 panic
flag 传不到子命令：--config 在 myapp server start 里读不到
这是因为普通 flag 不会向下透传。Cobra 分两类 flag：本地 flag（仅当前命令可用）和 persistent flag（向所有后代命令透传）。混淆这两者是参数绑定失效的最常见原因。
典型错误写法：rootCmd.PersistentFlags().String("config", "", "") 声明了，但子命令里用 subCmd.Flags().String("config", "", "") 再声明一次，还试图 BindPFlag 绑定——这反而覆盖了继承关系。
- 想让
--config在任意子命令都可用，只在rootCmd上声明一次：rootCmd.PersistentFlags().String("config", "", "config file path") - 子命令中直接读取：
viper.GetString("config")或cmd.Flag("config").Value.String() - 若某子命令需要自己独有的 flag（如
--timeout），用subCmd.Flags().Int("timeout", 30, "")声明即可，无需绑定 -
BindPFlag是把 flag 和变量绑定，不是“继承 flag”，别滥用
Args 校验总失败：cobra.ExactArgs(2) 却提示 unknown shorthand flag
这不是校验逻辑错了，而是参数顺序触发了 Cobra 的解析规则：它默认严格按“flag → args”顺序扫描。一旦遇到非 flag 形式的 token（比如 file1），就认为 args 开始，后续再出现的 -f 就被当成未知 flag 处理。
例如执行 myapp cp file1 file2 -f，Cobra 在看到 file1 后就停止解析 flag，-f 被丢进 args 列表，但校验又要求恰好 2 个 args，于是报错。
- 强制 flag 前置：改用
myapp cp -f file1 file2，这是最简单可靠的解法 - 若必须支持 flag 在后（如 git 风格），不要用
cobra.ExactArgs，改用cobra.ArbitraryArgs，然后在Run中手动分拆：args := cmd.Flags().Args()+ 手动识别-f类标记 - 也可预处理
os.Args：cmd.SetArgs(os.Args[1:])，再自行重排，但会绕过 Cobra 原生解析逻辑，慎用
RootCmd 初始化后不执行 Execute() 导致命令静默退出
很多新手写完 rootCmd 和子命令，却忘了在 main() 里调用 Execute()，结果程序跑完没报错也没输出，像什么都没发生。
注意 Execute() 不是自动生成的——它得你手动实现并调用。官方模板里通常封装在 cmd.Execute() 中，但这个函数必须被 main() 显式触发。
- 入口文件（如
main.go）里必须有：if err := cmd.Execute(); err != nil { os.Exit(1) } -
cmd.Execute()内部会调用rootCmd.Execute()，进而触发整个命令树匹配与执行 - 如果用了
cobra.OnInitialize(initConfig)，它只在Execute()调用后、实际 Run 前执行，不调Execute()就不会触发 - 调试时可在
rootCmd.Run函数开头加fmt.Println("running root")，确认是否真进了执行流程
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
