cobra 注册子命令需调用 cmd.addcommand() 挂载独立 *cobra.command 实例，每个子命令须自包含 use、rune、flags 和 args 校验，且必须显式声明自身 flag 并正确添加到 rootcmd。
怎么用 Cobra 注册子命令
子命令不是靠手动拼接字符串或 if-else 分支实现的，而是通过 cmd.AddCommand() 把独立的 *cobra.Command 实例挂载上去。每个子命令都该是自包含的：有自己的 Use、Run、参数定义和帮助文本。
常见错误是把多个逻辑塞进同一个 Run 函数里，靠 args[0] 判断分支——这会让命令行行为不可预测，且 --help 无法正确显示各子命令的帮助。
- 每个子命令必须调用
rootCmd.AddCommand(subCmd)，不能只声明不注册 -
Use字段必须是单个单词（如"serve"），不能带空格或路径；带空格的会被 Cobra 截断 - 子命令的
Args校验（如cobra.ExactArgs(1)）只作用于它自己的参数，不影响父命令
子命令如何接收自己的 flag 和位置参数
Cobra 默认把所有 flag 和参数都“向上透传”，但子命令只能拿到属于它的那一部分。关键在初始化时用 subCmd.Flags() 或 subCmd.PersistentFlags() 显式声明，而不是复用根命令的 FlagSet。
容易踩的坑是：在子命令的 Run 里直接读 rootCmd.Flag，结果读到的是空值或父命令的默认值。
- flag 必须在
subCmd.Flags().String(...)中定义，再用cmd.Flag("name").Value或绑定变量读取 - 位置参数通过
cmd.Args（即args参数）传入Run函数，不是cmd.Flags().Args() - 如果多个子命令需要共用 flag（如
--verbose），用rootCmd.PersistentFlags()，否则子命令拿不到
为什么 go run main.go subcmd --help 不显示子命令帮助
因为 cobra.OnInitialize 或 init() 阶段没执行完，或者子命令没被正确添加到 root 命令树里。最常见原因是：子命令变量声明了，但忘记调用 AddCommand；或者 main() 里只执行了 rootCmd.Execute()，没提前构建完整命令链。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
另一个隐蔽问题是：子命令的 Run 或 RunE 是 nil，Cobra 会静默跳过该命令，连 help 都不生成。
- 检查
rootCmd.Commands()返回的 slice 长度是否大于 0 - 确保子命令的
Use不为空，且没有重复（重复Use会导致后注册的覆盖前一个） - 运行时加
-h看根命令列出的子命令名是否和你期望的一致；不一致就说明注册失败
参数解析顺序和 RunE 的返回值影响
Cobra 在调用 Run 前已做完 flag 解析、参数校验和类型转换。如果你用 RunE（返回 error），错误会被自动转成非零退出码并打印到 stderr；而 Run 没有错误传播机制，出错只能手动 os.Exit(1)。
性能上没区别，但可维护性差很多：RunE 能让错误统一由 Cobra 处理，比如自动附加 exit status 1 提示，还能配合 cmd.SilenceErrors = true 关闭默认报错输出。
- 始终优先用
RunE，除非逻辑极其简单且确定不会出错 -
cmd.SetArgs([]string{"--flag", "value"})只在测试中模拟输入，不影响实际 CLI 行为 - 不要在
Run或RunE里调用log.Fatal—— 它会绕过 Cobra 的退出流程，导致 help 文本丢失、退出码混乱
最常被忽略的是子命令的 Short 和 Long 字段：它们不仅影响 --help 输出，还决定子命令是否出现在根命令的 help 列表里。留空就等于“隐藏”了这个子命令。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
