Go CLI 工具怎么让 go run 支持 shell 补全？
不能直接补全——go run 本身不加载你的 CLI 工具的补全逻辑，它只是临时编译执行。真正要配的是你最终安装后的二进制命令（比如 mytool）。
常见错误现象：在 main.go 里调用 cobra.GenBashCompletionFile 生成了补全脚本，source 之后发现按 Tab 没反应。原因往往是没把生成的脚本路径加进 $PATH 对应的 shell 初始化文件，或者没 reload。
- 补全脚本必须由已安装的二进制生成，不是
go run：运行./mytool completion bash > /usr/local/etc/bash_completion.d/mytool（macOS Homebrew 环境）或~/.local/share/bash-completion/completions/（Linux） - bash 用户需确保
/etc/bash_completion或等效文件已被 source；zsh 用户要启用compinit并把补全目录加入fpath - 别用
go run main.go completion bash生成——这时os.Args[0]是go或临时路径，cobra写出的补全函数名会错（比如变成__start_go）
cobra 的 completion 子命令为什么生成的 zsh 补全不生效？
zsh 补全依赖函数名严格匹配命令名，而 cobra 默认用 os.Args[0] 推导函数名。如果二进制软链、重命名或通过 wrapper 调用，函数名就对不上。
使用场景：你用 ln -s mytool-v1.2 mytool，但补全脚本里注册的是 _mytool_v1_2，zsh 就找不到入口。
立即学习“go语言免费学习笔记（深入）”；
- 显式指定命令名：生成时加
--name mytool参数，例如mytool completion zsh --name mytool - zsh 补全脚本必须放在
$fpath中的某个目录（如~/zsh/completion），且执行过compinit - macOS 上 zsh 默认禁用非 Apple 补全，需手动运行
chmod +x补全脚本，并确认ZSH_DISABLE_COMPFIX=true（仅开发调试时设，线上慎用）
自定义补全逻辑时，ValidArgsFunction 和 ArgAliases 到底怎么选？
ArgAliases 只做静态字符串映射，适合别名（如 ls/list 都触发同一子命令）；ValidArgsFunction 是动态回调，能查文件、读配置、甚至发 HTTP 请求——但也意味着每次 Tab 都会执行它。
性能影响明显：如果函数里调用了 os.ReadDir 扫整个 ~/Downloads，补全会卡顿；更糟的是，某些 shell（如旧版 bash）会缓存失败结果，导致后续补全直接跳过。
- 静态别名优先用
ArgAliases：设置cmd.ArgAliases = []string{"lst"}，比写函数更轻量 -
ValidArgsFunction必须返回[]string和shellCompDirective，漏掉ShellCompDirectiveNoFileComp可能意外触发文件名补全 - 避免在补全函数中做网络请求或阻塞 IO；如需远程数据，建议预加载到内存或加本地缓存（如
time.Now().Sub(lastFetch) ）
Windows PowerShell 补全为什么总报 Register-ArgumentCompleter : The term 'Register-ArgumentCompleter' is not recognized？
PowerShell 版本太低（低于 5.0），或者当前会话未启用执行策略。这不是 Go 或 cobra 的问题，是环境没准备好。
兼容性影响：PowerShell Core（7+）默认支持，但 Windows 自带的 PowerShell 5.1 需手动初始化，且企业锁机环境下常被禁用 RemoteSigned 策略。
- 先运行
$PSVersionTable.PSVersion确认版本 ≥ 5.0；若低于，升级或改用pwsh（PowerShell Core） - 补全脚本需以
.ps1后缀保存，并用Set-ExecutionPolicy RemoteSigned -Scope CurrentUser解除限制（管理员权限非必需） - cobra 生成的 PowerShell 补全脚本依赖
Get-Help输出，确保你的命令设置了cmd.Short和cmd.Long，否则补全描述为空
最常被忽略的一点：补全函数名大小写必须和命令名完全一致——MyTool 和 mytool 在 PowerShell 里是两个不同函数，Windows 文件系统不区分大小写，但 PowerShell 补全注册器区分。
