cobra init后命令不生效是因为只生成骨架，子命令未通过rootcmd.addcommand()注册；需检查cmd/下文件是否存在、init函数是否调用addcommand、变量名大小写是否一致，并手动导入cmd包触发init。
为什么 cobra init 后命令不生效？
刚跑完 cobra init，执行 go run main.go 却提示 “command not found” 或直接退出——根本没注册子命令。这是因为 cobra init 只生成骨架，rootCmd 的 Execute() 虽然调用了，但所有子命令（比如 add、list）还没被 rootCmd.AddCommand() 注册进去。
- 检查
cmd/目录下是否真有对应命令文件（如cmd/add.go），且其中init()函数是否调用了rootCmd.AddCommand(addCmd) - 确认
addCmd变量名和AddCommand()传入的变量名完全一致，Go 区分大小写，AddCmd和addCmd是两个东西 - 如果用
cobra add xxx生成命令，它默认往cmd/xxx.go写，但不会自动 import 该文件 —— 你得手动在main.go或root.go里加一行_ "your-module/cmd"（或显式 import）来触发init()
如何让 cobra add 生成的命令支持 flag 和参数？
生成的 cmd/xxx.go 里 xxxCmd.Flags() 是空的，Args: 默认是 cobra.ExactArgs(0)，意味着不允许任何位置参数。不改这里，用户输 mytool xxx file.txt 就直接报错。
- 添加 flag：在
init()函数里调用xxxCmd.Flags().StringP("output", "o", "", "output file path")，然后在runE回调里用cmd.Flags().GetString("output")读取 - 允许位置参数：把
Args:改成cobra.MinimumNArgs(1)或cobra.ArbitraryArgs，否则哪怕只输一个文件名也会被拦住 - 注意 flag 类型匹配：用
String()却调GetInt()会 panic；布尔 flag 推荐用BoolP并设默认值为false，避免 nil 指针问题
交叉编译时 cobra 命令行补全失效？
本地开发时 mytool completion bash 能输出脚本，但用 GOOS=linux GOARCH=arm64 go build 编译后，在目标机器上运行却提示 “unknown command 'completion'”——不是 bug，是补全命令默认被条件编译关掉了。
-
cobra的补全功能依赖golang.org/x/term和系统终端能力，官方为了减小二进制体积，默认在非主模块构建时禁用它 - 启用方式：编译时加
-tags completions，例如go build -tags completions -o mytool . - 如果你用 Makefile 或 CI 脚本批量构建，漏掉这个 tag 就白忙活；补全脚本本身是纯文本，不涉及平台差异，生成一次即可复用
为什么 RunE 返回 error 后程序还退出码为 0？
你在 RunE 里写了 return fmt.Errorf("not found")，终端也打印了错误信息，但 echo $? 居然是 0——Cobra 默认只把 RunE 的 error 当作日志输出，不自动映射为 exit code。
- 必须显式调用
os.Exit(1)才能控制退出码，但别在RunE里直接写，会绕过 Cobra 的 cleanup 流程 - 正确做法：在
main()中捕获rootCmd.Execute()的 error，并自己处理，例如：if err := rootCmd.Execute(); err != nil {<br> os.Exit(1)<br>} - 更稳妥的是用
cobra.OnInitialize注册清理函数，再配合os.Exit，否则 panic 或提前 exit 可能跳过 defer
