Golang命令行工具Cobra实战与语言学习中的工程交互设计-Golang-PHP中文网

rootcmd.execute()必须作为main()最后一行调用，否则命令树不加载，导致子命令报unknown command；rootcmd须为包级变量，子命令注册须在execute()前完成，flag作用域需区分flags()与persistentflags()。

golang命令行工具cobra实战与语言学习中的工程交互设计

不执行 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() 这一行（无其他逻辑干扰）

StringP() 的四个参数顺序固定：name、shorthand、defaultValue、usage。把短选项名（如 "c"）错放到第三个位置，运行时直接 panic：invalid shorthand format。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

正确写法：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 检查是否被意外覆盖

像 --config、--verbose 这类需要被所有子命令识别的 flag，如果只注册在某个子命令的 Flags() 上，就会出现 mytool --verbose server start 报错 unknown flag: --verbose。

cmd.Flags()：仅当前命令生效（如 server start --port）
cmd.PersistentFlags()：对该命令及其所有后代命令生效（如 rootCmd.PersistentFlags().String("config", ...)）
验证方式：运行 mytool --help 看 flag 是否列出；再运行 mytool server --help，如果 flag 没出现，说明没设成 persistent
别在每个子命令的 RunE 里重复解析配置——统一在 rootCmd.PreRunE 中用 Viper 加载，避免多次读文件或环境变量

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