你在使用git、kubectl或docker时，是否曾惊叹于它们强大的命令行补全功能？输入git checkout <Tab><Tab>，就能列出所有分支；输入kubectl get pod -n <Tab>，就能自动补全命名空间。这种体验不仅提升效率，也让命令行操作更可靠。
那么，我们自己写的 Shell 脚本或内部工具，能不能也拥有这种“智能补全”能力？
答案是：完全可以！而且实现起来并不复杂。今天我们就花一个晚上，掌握 Linux（Bash）下自定义命令参数补全（Programmable Completion）的核心方法。
一、为什么需要自定义补全？
- 减少输入错误：避免拼错命令、参数或文件名。
- 提升效率：无需记忆所有选项，通过 Tab 探索即可。
- 增强专业性：让内部工具具备和主流 CLI 工具一样的用户体验。
- 降低使用门槛：对新同学更友好。
二、Bash 补全机制简述
Bash 通过complete命令和补全函数（completion function）实现可编程补全。核心思路是：
- 注册补全规则：告诉 Bash 某个命令使用哪个函数来处理补全。
- 编写补全函数：该函数根据当前输入上下文（如已输入的参数、光标位置等），动态生成候选补全项。
关键变量：
COMP_WORDS：当前命令行所有单词的数组（如["mycmd", "arg1", ""]）COMP_CWORD：当前光标所在单词的索引（从 0 开始）COMPREPLY：函数需将候选补全项写入此数组，Bash 会自动展示
三、实战：为自定义命令mytool添加补全
假设我们有一个内部运维工具mytool，支持以下子命令：
mytool deploy<env><service>mytool logs<service>mytool status其中：
<env>可选值：dev,test,prod<service>可选值：api,web,worker
Step 1：编写补全函数
创建文件/etc/bash_completion.d/mytool（或放入~/.bash_completion）：
_mytool_completion(){localcur prev words cword _init_completion||returncur="${COMP_WORDS[COMP_CWORD]}"prev="${COMP_WORDS[COMP_CWORD-1]}"if[[$cword-eq1]];thenCOMPREPLY=($(compgen -W"deploy logs status"--"$cur"))return0ficase"${COMP_WORDS[1]}"indeploy)if[[$cword-eq2]];thenCOMPREPLY=($(compgen -W"dev test prod"--"$cur"))elif[[$cword-eq3]];thenCOMPREPLY=($(compgen -W"api web worker"--"$cur"))fi;;logs)if[[$cword-eq2]];thenCOMPREPLY=($(compgen -W"api web worker"--"$cur"))fi;;status);;*);;esac}complete -F _mytool_completion mytoolStep 2：生效与测试
source/etc/bash_completion.d/mytool然后尝试：
$ mytool<Tab><Tab>deploy logs status补全生效！
四、实战案例：为ssh命令补全/etc/hosts中的主机名和 IP
在日常运维中，我们经常通过ssh连接内网服务器，而这些服务器通常已在/etc/hosts中定义了别名。如果能用<Tab>自动补全这些主机名甚至对应的 IP 地址，将极大提升效率。
✅ 推荐做法：动态读取/etc/hosts
在~/.bashrc中添加以下函数：
_ssh_hosts_completion(){# 从 /etc/hosts 提取所有非注释行的有效主机名和 IPlocalentriesentries=$(awk'!/^($|#)/ { ip =$1for (i = 2; i <= NF; i++) { print$i"\n" ip } }'/etc/hosts|sort-u)COMPREPLY=($(compgen -W"${entries}"--"${COMP_WORDS[COMP_CWORD]}"))}# 注册到 ssh 命令complete -F _ssh_hosts_completionssh🔍 优势说明
- 支持多别名：一行
192.168.1.10 web01 db01会同时补全web01、db01和192.168.1.10。 - 自动去重：
sort -u避免重复项。 - 实时生效：每次按
<Tab>都会重新读取/etc/hosts，无需重启 Shell。 - 跳过注释/空行：
!/^($|#)/确保只处理有效行。
🔄 生效方式
echo'source ~/.bashrc'# 确保上面代码已写入source~/.bashrc🧪 使用效果
$ssh<Tab><Tab>10.0.0.5192.168.1.10 api-server db01 web01现在，无论是用主机名还是 IP 登录，都能一键补全！
💡 提示：此方法特别适合内网环境（如 K8s 节点、数据库、测试机等）已通过 hosts 统一管理的场景。
五、进阶技巧
1. 动态补全（如从 API 获取）
你可以让补全函数调用外部命令。例如，从 Jenkins 获取作业名：
COMPREPLY=($(curl-s http://jenkins/api/json|jq -r'.jobs[].name'|grep"^$cur"))⚠️ 注意：补全函数应尽量快速，避免阻塞命令行。
2. 文件/目录补全
使用-f（文件）或-d（目录）：
complete -f mytool# 补全文件或在函数中调用_filedir。
3. 支持 Zsh？
Zsh 使用完全不同的补全系统（compdef），但可通过bashcompinit兼容 Bash 补全脚本：
autoload -Uz bashcompinit bashcompinit source /etc/bash_completion.d/mytool六、总结
通过为自定义命令添加智能参数补全，我们不仅提升了使用体验，也让内部工具更加“专业”。这是一项投入小、回报高的技能，特别适合运维、开发工具链建设等场景。
无论是为内部脚本mytool添加子命令支持，还是为ssh接入/etc/hosts的全部资源，只需几行 Bash 代码，就能让命令行飞起来。
下次写 Shell 脚本时，不妨多加 10 行代码，给它穿上“智能外衣”。
小提示：如果你使用 Jenkins、Yearning 或其他内部平台，也可以考虑为常用 CLI 封装补全逻辑，让团队效率再上一个台阶。
参考资料：
man bash（搜索 Programmable Completion）- Bash Completion GitHub
