bash-completion若未生效，可按以下步骤手动配置：首先检查其是否已加载，确认所使用的shell类型；接着在~/.bashrc文件中添加source路径，然后重载配置。此外，补全脚本必须放置在指定目录且命名正确；对于自定义命令，需要编写补全函数并进行注册。当候选内容过多时，还可对Bash补全行为进行调整。
bash-completion 没加载，补全根本不会生效
安装了 bash-completion 包并不意味着它就能自动运行。许多发行版（例如最小化安装的Ubuntu Server或CentOS Stream）虽然安装了该包，但在shell启动时并没有加载补全脚本。
先确认是否加载：
- 运行
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 只列出文件，不是 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？
自己写的工具默认零补全。得写补全函数并注册，核心是三件事：初始化变量、判断当前参数位置、填 COMPREPLY 数组。
示例片段（放 ~/.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，比git checkout候选少得多
真正麻烦的不是这个提示，而是补全函数没过滤好候选——比如把整个 /tmp 下的文件都塞进 COMPREPLY，那问题不在交互逻辑，而在函数本身。
