用cobra初始化项目后需重构结构：将execute移至main.go，子命令分文件注册，配置在persistentprerune中加载并存入context，flag值校验必须在rune中手动进行，args仅校验位置参数数量。
直接用 cobra 初始化项目比手写命令树快得多，但很多人卡在初始化后不知道怎么组织子命令、传参和配置加载——核心问题不是“会不会用”，而是“结构怎么搭才不踩坑”。
用 cobra init 生成骨架后必须改掉的默认路径
执行 cobra init myapp 会默认把命令注册到 cmd/root.go，但实际项目里几乎立刻要拆分：主命令逻辑太长、子命令需要独立测试、配置初始化要提前于命令执行。不改路径会导致后续加功能越来越难维护。
- 把
cmd/root.go里的Execute()调用移到main.go，只留NewRootCmd()构造函数 - 每个子命令单独建文件，比如
cmd/serve.go，用rootCmd.AddCommand(serveCmd)注册 - 配置（如 viper）初始化放在
cmd/root.go的init()或PreRunE钩子里，别塞进RunE
RunE 和 Args 配合校验参数时的典型错误
很多人以为 Args: cobra.ExactArgs(1) 就能防住空参数，结果运行时还是 panic —— 因为 Args 只校验位置参数（cmd arg1 arg2），不校验 flag 值是否为空。真正要校验 flag，得在 RunE 开头手动检查。
-
Args适合约束必填位置参数数量，比如git commit -m "msg"中的"msg"是位置参数，-m是 flag - flag 值校验必须在
RunE里做：if cfg.File == "" { return fmt.Errorf("--file is required") } - 别依赖
RequiredFlags自动报错，它只检查 flag 是否被传入，不检查值是否为空字符串
子命令间共享配置和状态的两种安全方式
多个子命令都要读数据库地址、日志级别等，硬编码或全局变量会破坏可测试性。cobra 本身不提供依赖注入，得自己设计轻量方案。
- 把配置结构体作为字段嵌入每个
*cobra.Command，在NewXXXCmd(cfg *Config)构造时传入 - 用
cmd.PersistentFlags()注册公共 flag（如--verbose），然后在rootCmd.PersistentPreRunE里解析并存到cmd.Context()，子命令从cmd.Context().Value()取 - 避免用包级变量存配置，否则单元测试时无法隔离不同命令的配置实例
最常被忽略的是 PersistentPreRunE 的执行时机：它在所有子命令的 PreRunE 之前执行，且只触发一次，适合做一次性的初始化（如连接池、配置加载）。如果在这里 panic，整个命令链就断了，但错误信息不会自动打印——得自己捕获并调用 fmt.Fprintln(cmd.OutOrStderr(), err)。
