bash-completion未生效需依次检查：shell是否为bash、包是否安装、/etc/profile.d/bash_completion.sh是否被source、~/.bashrc是否包含对应source语句并重载；新命令需手动添加补全脚本；alias不支持自动补全，应改用函数或手动绑定。
bash-completion 没生效？先确认 shell 和包状态
大多数 Linux 发行版默认没启用 bash-completion，不是装了就自动工作。你敲 git che<Tab> 没反应，大概率是它根本没加载。
- 检查当前 shell：运行
echo $SHELL，确保是/bin/bash（不是zsh或fish） - 查包是否已安装：
dpkg -l bash-completion（Debian/Ubuntu）或rpm -q bash-completion（RHEL/CentOS/Fedora） - 如果没装，用对应命令安装：
sudo apt install bash-completion或sudo dnf install bash-completion - 装完别急着重启终端——它通常只在新会话中加载，但还要看配置文件是否触发
/etc/profile.d/bash_completion.sh 是否被 source
Debian 系发行版把入口脚本放在 /etc/profile.d/bash_completion.sh，但它不会自动执行，得靠你的 shell 配置去 source 它。
- 打开
~/.bashrc，找有没有这行：source /usr/share/bash-completion/bash_completion或source /etc/profile.d/bash_completion.sh - 如果没有，加一行进去（推荐前者，路径更通用；后者在某些 CentOS 版本里才存在）
- 改完别忘了重载：
source ~/.bashrc，而不是关掉终端再开——后者容易误以为“没用”，其实是没 reload - 注意：如果系统级脚本被注释掉（比如某些最小化安装的镜像），光改用户侧
.bashrc也不够，得先确认/etc/profile.d/下的脚本可读且未被禁用
补全不支持新命令？补全脚本没加载或位置不对
bash-completion 自带对 apt、systemctl、docker 等常用命令的支持，但像 pnpm、deno、自定义脚本这类，默认不识别。
- 先查补全脚本是否存在：
ls /usr/share/bash-completion/completions/ | grep pnpm（替换为你想补全的命令） - 如果没找到，去对应工具官网找官方补全脚本（比如
pnpm提供pnpm completion bash输出脚本内容） - 把输出保存到
/usr/share/bash-completion/completions/pnpm（需 root）或~/.local/share/bash-completion/completions/pnpm（用户级，需确保~/.local/share/bash-completion在$BASH_COMPLETION_DIR或被手动source） - 补全脚本必须是可执行权限？不需要；但文件名必须和命令名完全一致（区分大小写），且不能带扩展名（如
pnpm.bash就无效）
为什么 alias 补全失败？bash-completion 不处理 alias 展开
你写了 alias gs='git status'，然后敲 gs <Tab> 没反应——这不是 bug，是设计如此。bash-completion 只对原始命令名注册补全逻辑，不解析 alias。
- 解决办法只有两个：
complete -F _git gs（手动绑定 git 的补全函数到 alias 名），或者 - 改用
git status <Tab>直接操作——补全质量更高，因为_git函数知道所有子命令上下文 - 别试图用
complete -o default -o bashdefault gs，它只会 fallback 到文件名补全，毫无意义 - 如果你大量依赖 alias，建议优先用 shell 函数替代：
gs() { git status "$@"; }，函数可以正常绑定补全（complete -F _git gs有效）
.bashrc 就万事大吉，却忽略了补全脚本路径、alias 限制、以及不同发行版默认策略差异。 
