自动补全功能必须手动注册，cobra-cli init 不会自动生成；需显式添加 completion 子命令、调用 GenBashCompletionFile 等生成脚本，并按 shell 要求 source 或配置 fpath，否则 Tab 静音。
自动补全功能必须手动注册，cobra-cli init 不会自动生成
默认生成的 Cobra 项目不带自动补全支持，哪怕你用了 cobra-cli init 或 cobra-cli add。补全逻辑需要显式调用 cmd.RegisterFlagCompletionFunc 或启用 shell 补全命令（如 myapp completion bash），否则用户敲 Tab 就是静音。
常见错误现象：运行 myapp serve --port<tab></tab> 没反应；或执行 myapp completion zsh 后 source 了但子命令仍不补全。
- 补全命令本身由
cmd.GenBashCompletionFile/cmd.GenZshCompletionFile等函数生成，但需在 root 命令中显式添加一个completion子命令（Cobra 不自动加） - 对某个 flag 做自定义补全（比如
--config只列出当前目录下的.yaml文件），要用cmd.RegisterFlagCompletionFunc("config", func(...)，且该注册必须在cmd.Execute()之前完成 - zsh 补全要求文件名是
_myapp并放在fpath路径下，bash 则依赖complete -o default -o bashdefault -o nospace -F _myapp myapp这类初始化语句，漏掉任意一环都会失效
RunE 比 Run 更适合错误处理，但别在 RunE 里调用 os.Exit
如果你返回非 nil error，Cobra 会自动打印错误并退出（状态码 1）；而 Run 里 panic 或 os.Exit(1) 会跳过 Cobra 的错误包装和日志前缀，导致输出不一致，比如：
Error: failed to bind port: invalid port "abc"（正确） vs failed to bind port: invalid port "abc"（少前缀，难定位）
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
RunE函数签名是func(*cobra.Command, []string) error，返回 error 即可，Cobra 自动处理格式化与退出码 - 若你在
RunE中自己调用os.Exit，会导致PostRun、PreRun、Run链中断，比如日志关闭、资源清理逻辑被跳过 - 只有极少数场景（如 SIGINT 处理后强制终止）才需要
os.Exit，此时应确保已手动执行清理，而非依赖 Cobra 生命周期钩子
子命令参数绑定顺序影响 flag 解析结果
Cobra 默认按命令树深度优先解析 flag：先匹配当前命令的 local flag，再 fallback 到 parent 的 persistent flag。但如果你在子命令里重复定义同名 flag（比如 serve 和 root 都声明 --verbose），行为取决于注册顺序和 flag 类型。
- 用
cmd.Flags().BoolVarP注册的是 local flag，只对该命令生效；用cmd.PersistentFlags().BoolVarP注册的会被所有子命令继承 - 如果子命令同时有 local
--port和 parent 的 persistent--port，Cobra 会取 local 的值 —— 但不会报错，容易误用 - 位置参数（
args）永远属于最末端命令，myapp serve host port中的host和port传给serve的RunE，而不是root；但 flag 可跨层级传递，这点常被忽略
Viper 集成时配置项优先级容易被覆盖
很多人把 Viper 和 Cobra 一起用，以为 “配置文件 + flag + env” 自动按预期优先级生效，结果发现 --port=8080 没生效，还是读了 config.yaml 里的 port: 3000。
- Viper 的默认优先级是：flag > env > config file > default，但前提是 flag 必须通过
viper.BindPFlag("port", cmd.Flags().Lookup("port"))显式绑定，否则 flag 修改不会同步到 Viper 实例 - 如果你在多个命令里分别调用
viper.SetConfigFile，后调用的会覆盖前面的，建议只在 root 命令初始化一次，并用viper.WatchConfig()监听变更 - 环境变量名默认是大写下划线（
MYAPP_PORT），但若你用viper.SetEnvPrefix("myapp")却没调用viper.AutomaticEnv()，env 就完全不起作用
补全注册、RunE 错误传播、flag 绑定顺序、Viper 绑定时机——这四点不手动验证，工具上线后第一反馈往往是“Tab 不好使”“报错没提示”“配置不生效”，而不是功能逻辑问题。
