cobra-cli init 项目需先执行 go mod init 初始化模块，否则因缺少 go.mod 导致 cobra 包导入失败；add 命令遇同名文件静默退出，需手动删除后重试；version/help 失效多因 Version="" 或 SetHelpCommand 覆盖；Windows 补全需 PowerShell 策略调整或使用 WSL。
cobra-cli init 生成的项目为什么不能直接 run
因为 cobra-cli init 只创建骨架，不初始化 Go module，main.go 里引用的 github.com/spf13/cobra 会报错：找不到包。Go 1.16+ 默认启用 module 模式，没 go.mod 就无法解析导入路径。
实操建议：
- 先在空目录下运行
go mod init example.com/myapp（模块名要合法，别用本地路径） - 再执行
cobra-cli init，它会自动识别已有go.mod并写入依赖 - 如果已误操作，删掉
cmd/root.go和main.go，重新cobra-cli init即可，不用手动改 import 路径
add command 时提示 “command already exists” 怎么办
这是 cobra-cli add 的默认行为：它会检查 cmd/ 下是否已有同名文件（比如你执行 cobra-cli add serve，但 cmd/serve.go 已存在），就直接退出，不覆盖。
常见错误现象：反复执行 cobra-cli add xxx 没反应，也没报错，命令像“消失”了。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 确认文件是否存在：
ls cmd/*.go，看有没有重名的xxx.go - 想强制覆盖，先删旧文件：
rm cmd/xxx.go，再cobra-cli add xxx - 注意：
cobra-cli add不会自动注册子命令到 rootCmd，得手动在cmd/root.go的rootCmd.AddCommand(serveCmd)补上
为什么 build 出来的二进制没有 version 和 help 自动支持
Cobra 默认开启 version 和 help 子命令，但前提是：你的 rootCmd 没显式禁用它们，且没覆盖 Version 字段为空字符串。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
容易踩的坑：
- 在
cmd/root.go里写了rootCmd.Version = ""→--version消失 - 调用了
rootCmd.SetHelpCommand(&cobra.Command{})→ 帮助系统被清空 - 用
go build -o myapp .编译没问题，但用go install后执行myapp help报错：说明rootCmd.Use或Short是空的，Cobra 拒绝初始化 help
实操建议：保留 rootCmd.Version = "v0.1.0"，确保 rootCmd.Short 非空；不需要定制 help 逻辑时，完全不用碰 SetHelpCommand。
Windows 下 cobra-cli 生成的命令无法 tab 补全
Cobra 支持 bash/zsh/fish 补全，但 Windows 默认用 PowerShell 或 CMD，原生不支持 source 补全脚本。你执行 cobra-cli completion powershell > cobra.ps1，然后手动加载，但 PowerShell 默认策略禁止执行本地脚本。
使用场景：CI/CD 或本地调试需要快速输入子命令，补全能省不少时间。
实操建议：
- 临时绕过策略：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 加载补全：
. ./cobra.ps1（注意前面的点和空格） - 更稳妥的做法：用 WSL，在里面跑 bash +
cobra-cli completion bash，体验接近原生 - 别试图在 CMD 里补全——Cobra 不提供 CMD 补全支持，官方明确不维护
补全逻辑依赖 Args 和 ValidArgs 字段，自定义参数校验时如果清空了 ValidArgs，补全也会失效。
