cobra-cli init 生成的结构需保留关键硬编码逻辑：rootCmd 必须为全局变量，init 中 viper.AutomaticEnv() 和 SetEnvPrefix 不可删，PersistentFlags 的 config 标志须保留以触发 ReadInConfig；RunE 中应先 BindPFlags 再用 viper 读取，避免绕过优先级；子命令参数校验须用 Args 字段而非 MarkFlagRequired。
直接用 cobra-cli 初始化项目，比手写 rootCmd 结构体更可靠——它自动处理 initConfig、PreRunE 时机、--version 注入和错误退出码，手写容易漏掉关键钩子。
为什么 cobra-cli init 生成的结构不能乱改
生成的 cmd/root.go 里有几处硬编码逻辑必须保留：
-
var rootCmd = &cobra.Command{...}必须赋值给全局变量，否则cobra-cli add新增子命令时无法自动注册 -
func init() { ... }中的viper.AutomaticEnv()和viper.SetEnvPrefix(...)不能删，否则环境变量（如YOURTOOL_DEBUG=1）不会被识别 -
rootCmd.PersistentFlags().String("config", "", "config file (default is $HOME/.yourtool.yaml)")这行要留着，它是viper.ReadInConfig()的触发开关
改错位置最常见后果：执行 yourtool --help 时 panic，或 --config 标志传了但配置没加载。
RunE 函数里别直接调 cmd.Flags().GetString()
虽然语法上能跑通，但会绕过 Viper 的优先级合并机制（命令行 > 环境变量 > 配置文件 > 默认值）。正确做法是先绑定再读取：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 在
init()或PreRunE中调用viper.BindPFlags(cmd.Flags()) - 在
RunE中统一用viper.GetString("port")，而不是cmd.Flag("port").Value.String() - 如果标志名含短横线（如
--http-port），记得加viper.SetEnvKeyReplacer(strings.NewReplacer("-", "_"))，否则HTTP_PORT环境变量不生效
漏掉 BindPFlags 是导致“配置文件写了 port: 3000，但命令行传 --port=4000 却不生效”的主因。
子命令参数校验必须用 Args 字段，不是 MarkFlagRequired
MarkFlagRequired("output") 只校验标志，对位置参数（如 yourtool convert input.json output.yaml）完全无效。正确方式：
- 用
cmd.Args = cobra.ExactArgs(2)要求恰好两个位置参数 - 用
cmd.Args = cobra.MinimumNArgs(1)要求至少一个 - 自定义校验函数：
cmd.Args = func(cmd *cobra.Command, args []string) error { if len(args)
没设 Args 时，args 切片永远为空，哪怕用户输了一串参数——这是新手最常踩的静默坑。
真正难的不是写命令，而是让不同来源的配置（flag、env、file）按预期顺序覆盖；Viper 的 BindPFlags 和 AutomaticEnv 调用顺序、环境变量命名规则、配置文件搜索路径，三者稍有错位，就会出现“以为生效了其实没生效”的情况。
