rootCmd.Execute()必须作为main()最后一行调用，否则命令树不加载，导致子命令报unknown command；rootCmd须为包级变量，子命令注册须在Execute()前完成，flag作用域需区分Flags()与PersistentFlags()。
rootCmd.Execute() 必须放在 main() 最后一行
不执行 rootCmd.Execute()，整个命令树就压根没加载，所有子命令都会报 unknown command 或静默失败——这是 90% 的“命令找不到”问题的根源。
Cobra 的命令树是惰性构建的：Execute() 才真正触发解析、匹配和执行流程。它不是初始化函数，而是启动引擎。
-
rootCmd必须是包级变量（不能在main()里new(cobra.Command)后返回） - 子命令注册（
rootCmd.AddCommand(xxxCmd)）必须在Execute()调用前完成，常见位置是init()或main()开头 - 别用
ExecuteC()，除非你明确要自己处理返回的*cobra.Command和error；默认就用Execute() - 如果用了
cobra-cli init生成骨架，检查main.go是否只剩cmd.Execute()这一行（无其他逻辑干扰）
flag.StringP() 参数顺序写错会 panic
StringP() 的四个参数顺序固定：name、shorthand、defaultValue、usage。把短选项名（如 "c"）错放到第三个位置，运行时直接 panic：invalid shorthand format。
- 正确写法：
cmd.Flags().StringP("config", "c", "./config.yaml", "配置文件路径") - 错误写法：
cmd.Flags().StringP("config", "./config.yaml", "c", "配置文件路径")—— 把默认值当成了短选项 - 短选项只能是单字符：
"cfg"、""、"-f"全部非法 - 多个子命令若都调用
cmd.Flags().String("v", ...)，后注册的会静默覆盖前一个；可用cmd.Flags().Lookup("v").Usage检查是否被意外覆盖
全局 flag 必须挂到 rootCmd.PersistentFlags()
像 --config、--verbose 这类需要被所有子命令识别的 flag，如果只注册在某个子命令的 Flags() 上，就会出现 mytool --verbose server start 报错 unknown flag: --verbose。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
cmd.Flags()：仅当前命令生效（如server start --port） -
cmd.PersistentFlags()：对该命令及其所有后代命令生效（如rootCmd.PersistentFlags().String("config", ...)） - 验证方式：运行
mytool --help看 flag 是否列出；再运行mytool server --help，如果 flag 没出现，说明没设成 persistent - 别在每个子命令的
RunE里重复解析配置——统一在rootCmd.PreRunE中用 Viper 加载，避免多次读文件或环境变量
Args 校验函数里拿不到 flag 值
cobra.ExactArgs(2) 这类校验只检查位置参数个数，**不触发 flag 解析，也不访问任何 flag 变量值**。它运行在 flag 解析完成之后、RunE 执行之前，但此时 flag 值尚未绑定到变量。
- 不要在
Args函数里尝试读cmd.Flag("x").Value.String()或viper.GetString("x")，它们都为空或未初始化 - 如果校验逻辑依赖 flag 值（比如 “当
--force为 true 时允许少传一个参数”），必须把校验逻辑移到RunE开头 - Cobra 不会自动解析 args 中的
-f或--force：像myapp cp file1 file2 -f中的-f会被当作文本参数，报unknown shorthand flag；必须写成myapp cp -f file1 file2 - 若真需支持 Git 风格（flag 在 args 后），得手动调
cpCmd.SetArgs(os.Args[cpCmd.ArgsLenAtDash()+1:])并配合cobra.ArbitraryArgs
最易被忽略的其实是上下文共享：微服务 CLI 的 serve、health、status 子命令，不该各自初始化 logger、viper 或数据库连接——这些必须在 rootCmd.PreRunE 统一做，且失败要提前退出，否则子命令执行时 panic 就没机会暴露真实原因。
