cobra 不提供开箱即用的命令自动补全或语义级建议能力，需手动集成 shell 补全脚本并编写自定义提示逻辑，包括生成、安装补全脚本及实现动态候选值、拼写纠错和工程化路径建议等。
cobra 本身不提供命令自动补全或语义级建议能力，所谓“自动化建议”必须由你手动集成 shell 补全 + 自定义提示逻辑，否则用户敲 mytool <tab></tab> 不会弹出子命令或参数候选。
shell 补全不是开箱即用的
运行 cobra-cli add 或手写 cobra.Command 后，--help 和子命令结构有了，但 mytool <tab></tab> 默认什么都不会发生。Cobra 只内置生成补全脚本的能力，不自动安装或注册。
- 补全脚本需显式调用
rootCmd.GenBashCompletionFile或rootCmd.GenZshCompletionFile生成 - 用户必须手动把生成的脚本 source 进 shell（如
source ./completion.bash），或放入/usr/local/share/bash-completion/completions/等标准路径 - Zsh 用户还需额外执行
autoload -U compinit && compinit才能生效 - 补全内容仅限已注册的子命令名、flag 名和固定值（如
--format json|yaml），无法动态建议文件路径、配置项名或业务关键词
想实现“语言学习工程化”的提示，得自己 hook Args 和 Flag 解析
比如用户输入 mytool learn --lang <tab></tab>，你想列出当前支持的 go、rust、zig，这不是 Cobra 默认行为。你需要：
- 在
learnCmd.PersistentFlags().StringVarP(&lang, "lang", "l", "", "language to learn")之后，为该 flag 注册自定义补全函数：learnCmd.Flags().SetAnnotation("lang", cobra.BashCompCustom, []string{"__mytool_lang_list"}) - 在 shell 脚本里定义
__mytool_lang_list()函数，调用mytool list-langs --no-headers获取实时列表 - 注意：该机制只对 Bash/Zsh 有效，Fish 需单独适配；且
list-langs必须快（毫秒级），不能依赖网络或慢 IO
别混淆 “帮助生成” 和 “智能建议”
cobra.Command.Long 和 Example 字段生成的是静态 help 文本，--help 输出后就结束了。它不会在用户输错时主动提示相似命令（如输成 mytool ad 却没 ad 命令，不自动建议 add）。
- 拼写纠错需自己实现 Levenshtein 距离比对，在
rootCmd.Execute()失败后检查args[0]是否接近某个已注册Command.Use - 参数缺失提醒（如
mytool learn没给语言）靠Args: cobra.ExactArgs(1)或自定义Args函数，但错误信息仍是静态字符串，没法动态说“试试--lang go？” - 真正“工程化学习路径”建议（如“学完 go basic 后推荐 next: go test”）必须另建规则引擎或状态机，和 CLI 解析层解耦，不能塞进
Run函数里
容易被忽略的兼容性断点
补全脚本在不同 shell 版本下行为不一致，尤其 Zsh 5.8+ 对 _arguments 的要求更严；而 Windows PowerShell 补全需完全重写，Cobra 不提供 GenPwshCompletionFile（截至 v1.9.0）。
- Mac 上默认 zsh，但很多 CI 环境仍是 bash，生成脚本前要确认目标环境
- 如果 CLI 工具要分发二进制，补全脚本必须随包一起发布，并在 install script 中完成 symlink 或 source 注册
-
cobra.OnInitialize里加载配置或初始化语言数据时，若失败会导致补全函数调用mytool list-langs直接 panic —— 补全过程不捕获主程序 panic
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
