子命令必须用独立cobra.Command实例并显式AddCommand注册，否则报unknown command；Use字段Windows需加.exe后缀；Args校验和flag绑定须在子命令内完成；应使用RunE替代Run以正确处理错误。
子命令不是靠 if args[0] == "serve" 手动分支实现的，必须用独立的 *cobra.Command 实例 + 显式 AddCommand() 注册，否则 myapp serve 会报 unknown command "serve"。
子命令必须显式 AddCommand 到父命令上
很多人生成了 cmd/serve.go 就以为完事了，其实 serveCmd 变量只是个结构体，Cobra 不会自动发现它。关键在注册动作：
-
rootCmd.AddCommand(serveCmd)必须出现在cmd/root.go的init()或包级变量初始化中 - 二级命令（如
config set-credentials）要两步：先configCmd.AddCommand(setCredentialsCmd)，再rootCmd.AddCommand(configCmd) - 检查
rootCmd.Commands()返回值长度，若为 0 说明没注册成功 - 变量名改了但
AddCommand(xxxCmd)没同步更新，会导致命令“消失”
Use 字段写错导致 Windows 下找不到命令
Go 编译出的 Windows 二进制默认带 .exe 后缀，但 Use: "myapp" 不含后缀，系统就找不到可执行文件：
- Windows 下必须改成
Use: "myapp.exe"，否则myapp.exe serve报“不是内部或外部命令” - Linux/macOS 无此问题，因为 shell 自动匹配可执行文件名（
myapp和myapp.exe不冲突） - 修改位置在
cmd/root.go的var rootCmd = &cobra.Command{ Use: ... } - 所有子命令的
Use也必须是纯单词，不能含空格或斜杠，比如Use: "set-credentials"合法，Use: "config set"会被截断
Args 校验和 flag 绑定必须在子命令自身完成
子命令无法自动继承父命令的参数规则或 flag，必须自己声明：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 位置参数校验写在子命令定义里：
Args: cobra.ExactArgs(1)，不是在Run里手写if len(args) == 0 - flag 必须调用
subCmd.Flags().StringVarP(&addr, "addr", "a", ":8080", "listen address")，不能复用rootCmd.Flag("addr") - 共用 flag（如
--verbose）要声明为 persistent：rootCmd.PersistentFlags().Bool("verbose", false, "")，子命令直接读cmd.Flag("verbose").Value.String() - 别用
BindPFlag去“继承” persistent flag——它只绑定变量，不改变作用域
RunE 替代 Run，避免 panic 静默失败
Run 函数里一旦出错（比如解析失败、I/O 错误），只能手动 os.Exit(1)，而 RunE 返回 error 后，Cobra 会自动打印错误、加颜色、设退出码：
- 把
Run: func(cmd *cobra.Command, args []string) { ... }改成RunE: func(cmd *cobra.Command, args []string) error { ... } - 所有可能失败的操作（如读配置、连数据库）都应返回
error，而不是panic -
RunE是唯一能被Execute()正确捕获并格式化输出的入口；Run出错时 help 不显示、stderr 无缩进、不带 usage 行
最常被忽略的是：子命令的 Use 和 Args 必须各自独立设置，且 AddCommand 调用顺序与命令层级严格对应——差一层，myapp config set-credentials 就永远解析不到第三级。
