子命令必须显式调用addcommand挂载到父命令上，否则报unknown command；use字段须为单单词；全局flag用persistentflags声明，局部flag在子命令中独立注册；务必使用rune统一错误处理。
多级命令不是靠嵌套定义自动生效的，必须显式调用 AddCommand 挂载到父命令上，否则 go run main.go subcmd 一定报 unknown command "subcmd"。
子命令注册后不识别？检查 AddCommand 是否漏调
常见错误是 new 出一个 userCmd，但没把它加进 rootCmd.Commands；或者二级命令 createCmd 创建了，却只挂到了 userCmd，忘了再把 userCmd 加进 rootCmd。
-
rootCmd.AddCommand(userCmd)是必须的，不能省 - 如果要支持
mytool user create，就得先userCmd.AddCommand(createCmd)，再rootCmd.AddCommand(userCmd) -
Use字段只能是单词，比如"user"合法，"user create"或"user/create"会导致解析失败 - 所有命令结构最终都得连到
rootCmd，Cobra 不会自动遍历未挂载的变量
flag 怎么让子命令能读，又不污染 help 输出
全局 flag（如 --verbose）应该用 PersistentFlags() 在 rootCmd 上声明；局部 flag（如 serve --port）必须在对应子命令上调用 Flags().StringVarP 注册。混用会导致 help 显示错乱、补全失效、甚至子命令收不到值。
- 全局 flag：在
init()或main()里写rootCmd.PersistentFlags().BoolP("verbose", "v", false, "enable verbose output") - 局部 flag：在
serveCmd初始化时调用serveCmd.Flags().IntVarP(&port, "port", "p", 8080, "listen port") - 不要在子命令里调
BindPFlag去“继承” root 的 flag——PersistentFlags声明后，子命令可直接用cmd.Flag("verbose").Value.String()或viper.GetBool("verbose")读取 - 子命令 help 里只显示自己注册的 flag，
PersistentFlags默认也会出现在 help 中，如需隐藏，加cmd.Flags().MarkHidden("verbose")
Run 还是 RunE？别让错误处理失控
用 Run 写业务逻辑，一旦内部 panic 或调用 log.Fatal，Cobra 就彻底失去控制权：help 不输出、补全中断、错误格式不统一。所有实际项目都应该用 RunE。
-
RunE返回error，Cobra 会自动打印带命令路径的错误信息，并退出非零状态码 - 在
RunE里做参数校验，比如if port == "" { return fmt.Errorf("--port is required") }，Cobra 会自动触发 usage 提示 - 避免在
RunE里调os.Exit或log.Fatal，这会让测试无法 mock 执行流 - 如果需要前置逻辑（如初始化配置），优先用
PreRunE，它也返回error，且在RunE前执行
最常被忽略的一点：根命令的 Execute() 调用必须包裹在 if err != nil { os.Exit(1) } 里，且整个 CLI 的业务逻辑必须收敛到各个 RunE 函数中——这不是风格问题，而是 Cobra 错误链、补全、测试可维护性的分水岭。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
