Cobra子命令应通过cobra-cli add自动生成而非手写嵌套，否则易导致层级错乱、help不联动；需用cobo.ExactArgs等校验参数，避免手动解析args；Windows下Use字段不带.exe需显式编译输出名；子命令help缺失flag说明需调用rootCmd.SetUsageFunc()。
子命令不是靠手写嵌套，而是用 cobra-cli add 自动生成
直接在代码里 new 一堆 cobra.Command{} 然后手动 AddCommand()，看着能跑，但一加到三级命令（比如 todo config set-credentials）就容易漏注册、错层级、help 不联动。Cobra 的设计哲学是“约定优于配置”，子命令该由工具生成，不是手搓。
实操建议：
- 进项目根目录后，执行
cobra-cli add config，自动生成cmd/config.go，并自动在cmd/root.go里调用rootCmd.AddCommand(configCmd) - 再执行
cobra-cli add set-credentials --parent config，它会把新命令挂到configCmd下，而不是 root —— 这步很多人手动写错，导致todo config set-credentials找不到命令 - 生成的文件里默认有
Run: func(cmd *cobra.Command, args []string) { fmt.Println("not implemented") }，必须立刻删掉或替换成真实逻辑，否则运行就只打印这句
Args 验证别用 len(args) != 1，用 cobra.ExactArgs(1) 或 cobra.MinimumNArgs(1)
手写 if len(args) == 0 { fmt.Fprintln(os.Stderr, "missing argument"); os.Exit(1) } 不仅重复、难维护，还会让错误提示和 Cobra 默认 help 格式不一致，比如不带颜色、不缩进、不显示 usage 行。
常见错误现象：
立即学习“go语言免费学习笔记（深入）”；
- 用户输
todo add没参数，程序 panic 或静默失败 -
todo list --done被当成list命令的参数，而非 flag，结果args[0]变成--done，逻辑错乱
正确做法：
- 在命令定义里加
Args: cobra.MinimumNArgs(1)：允许批量添加（todo add "a" "b"），空参数自动跳过 - 搭配
args = lo.Map(args, func(s string) string { return strings.TrimSpace(s) })清理首尾空格，避免存入""导致 JSON marshal 失败 - 不要在
Run里自己解析os.Args—— Cobra 已经帮你切好了args，且过滤了 flag
Windows 下命令找不到？检查 Use 字段是否带 .exe
Go 编译出的二进制在 Windows 上默认叫 myapp.exe，但 Cobra 生成的 Use: "myapp" 不含后缀，导致用户敲 myapp serve 时系统报“不是内部或外部命令”。这不是 bug，是设计使然：Cobra 的 Use 是命令行显示名，不是文件名。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
兼容性影响：
- Linux/macOS 用户完全无感，因为 shell 自动匹配可执行文件（
myapp和myapp.exe不冲突） - Windows 用户首次构建后常卡在这一步，尤其用 VS Code 终端或 PowerShell 运行时
解决办法只有两个：
- 编译时显式指定输出名：
go build -o myapp.exe .，然后确保文档和用户都用myapp.exe serve - 或改用
cobra-cli init --name myapp.exe（部分新版支持），但更推荐前者，清晰可控
子命令 help 为空或漏 flag？记得设 rootCmd.SetUsageFunc()
刚用 cobra-cli init 生成的模板，myapp config -h 会显示 help，但 myapp config set-credentials -h 可能只有一行 usage，没有父命令的全局 flag（比如 --config）说明，甚至直接空白。这是因为子命令 help 默认不继承父级 flag 文案。
原因很简单：rootCmd 没设置 UsageFunc，导致子命令 help 渲染时跳过了持久 flag 的描述。
实操建议：
- 在
cmd/root.go的init()函数末尾加一行：rootCmd.SetUsageFunc(customUsageFunc) -
customUsageFunc可复用 Cobra 内置的cobra.DefaultUsageFunc，或简单返回cmd.UsageString() - 不加这句，所有子命令的
-h都是残缺的；加了之后，--config这类 PersistentFlag 就会自动出现在每个子命令 help 里
最常被忽略的是这一行，因为它不报错、不 panic，只是 help 看着“不太对”，等用户真去查文档才暴露问题。
