bash-completion未生效需手动配置:检查是否加载、确认shell类型、在~/.bashrc中添加source路径并重载;补全脚本须置于指定目录且命名正确;自定义命令需编写补全函数并注册;候选过多时可调整bash补全行为。

bash-completion 没加载,补全根本不会生效
不是装了 bash-completion 包就自动工作。很多发行版(比如最小化安装的 Ubuntu Server 或 CentOS Stream)只装了包,但没在 shell 启动时 source 补全脚本。
先确认是否加载:
- 运行
complete -p | head -5,如果输出里几乎全是complete -o bashdefault -o default这类基础规则,说明高级补全没起来 - 检查
echo $SHELL是不是/bin/bash—— zsh 或 fish 用户走的是另一套机制 - 查
~/.bashrc里有没有这行:source /usr/share/bash-completion/bash_completion(Ubuntu/Debian 系主流路径)或source /etc/profile.d/bash_completion.sh(某些 RHEL/CentOS 版本) - 改完必须
source ~/.bashrc,关终端再开是懒办法,容易漏 reload
git、kubectl 这类命令补全不显示子命令?路径和加载顺序错了
你输 git che<tab></tab> 只列出文件,不是 checkout,说明 git 补全脚本压根没被 Bash 调用。
关键点:
- 补全脚本必须放在 Bash 能扫描到的位置:
/usr/share/bash-completion/completions/(系统级)或~/.local/share/bash-completion/completions/(用户级) - 文件名必须严格等于命令名:
git,不能叫git.bash或git_completion - 别给补全脚本加执行权限:
chmod +x会导致source失败,Bash 会报语法错误 - 验证脚本存在:
ls /usr/share/bash-completion/completions/git,不存在就去官网拿:kubectl completion bash > ~/.local/share/bash-completion/completions/kubectl
自定义脚本 mytool 怎么让它支持 mytool deploy dev<tab></tab>?
自己写的工具默认零补全。得写补全函数并注册,核心是三件事:初始化变量、判断当前参数位置、填 COMPREPLY 数组。
Linux AI 服务器 — 将 Linux 服务器转换为本地 AI 推理集群。使用 systemd、NVIDIA CUDA 实现无头 Linux AI,零 GUI 开销。
示例片段(放 ~/.bash_completion 或对应 completions 目录):
_mytool() {
local cur prev words cword
_init_completion || return # 必须调用,否则 COMP_CWORD 不准
case "${COMP_WORDS[1]}" in
deploy)
if [[ $COMP_CWORD -eq 2 ]]; then
COMPREPLY=($(compgen -W "dev test prod" -- "$cur"))
elif [[ $COMP_CWORD -eq 3 ]]; then
COMPREPLY=($(compgen -W "api web worker" -- "$cur"))
fi
;;
logs)
[[ $COMP_CWORD -eq 2 ]] && COMPREPLY=($(compgen -W "api web worker" -- "$cur"))
;;
esac
}
complete -F _mytool mytool
注意:
-
COMPREPLY必须是数组:COMPREPLY=("a" "b"),写成COMPREPLY="a b"就只补出一个字符串 -
case里"${COMP_WORDS[1]}"的引号不能少,否则带空格的参数(如mytool "prod env")会让下标错位 - 别用 alias 绑定命令——alias 不支持补全;要用函数或直接
complete -F绑定可执行文件名
补全后按 Tab 出现 “Display all 173 possibilities? (y or n)” 怎么跳过?
这是 Bash 默认行为,当候选超过一定数量(通常是 100)就拦截询问,防止刷屏。不是 bug,是保护机制。
如果你确定要一次性看全,可以临时关闭:
- 在当前会话设:
bind 'set completion-map-Ctrl-I on'(启用 Ctrl+I 强制补全) - 或永久禁用提示:在
~/.inputrc加set completion-map-Ctrl-I on和set page-completions off - 更实用的做法是缩小补全范围:比如先输
git checkout feat<tab></tab>,比git checkout<tab></tab>候选少得多
真正麻烦的不是这个提示,而是补全函数没过滤好候选——比如把整个 /tmp 下的文件都塞进 COMPREPLY,那问题不在交互逻辑,而在函数本身。










