bash-completion安装后部分命令不补全，因其仅提供框架和基础规则，conda、docker等需手动加载对应补全脚本；systemctl、git子命令等失效常因补全文件未source或shell非bash；Zsh用户误用bash配置亦会导致失败。
bash-completion 安装后为什么某些命令 still 不补全？
不是装了 bash-completion 就万事大吉。它只提供补全框架和部分预置规则，很多命令（比如 conda、docker、自研 CLI 工具）的补全脚本需要单独加载或手动注册。
常见现象：apt 和 ls 能补全，但 git checkout 按 Tab 只列文件、不列分支；systemctl 补全失败；conda 根本没反应。
- 检查是否已加载系统级补全：运行
source /etc/bash_completion，再试一次 - 确认当前 shell 是 Bash（不是 Zsh）：执行
echo $SHELL，输出应为/bin/bash - 某些包（如
docker-ce）安装后会把补全脚本放在/usr/share/bash-completion/completions/，但不会自动 source —— 需要手动加到~/.bashrc末尾：source /usr/share/bash-completion/completions/docker
- Ubuntu 22.04+ 默认启用
bash-completion，但仅对登录 shell 生效；若你在 Terminator 新建标签页，它可能启动的是 non-login shell，导致~/.bashrc未被完整读取 —— 解决方法是在~/.bashrc开头加一句：shopt -s expand_aliases
如何为特定命令（如 conda、mytool）添加自定义补全？
核心是用 complete 命令绑定一个补全函数，而函数逻辑由你自己控制。这不是“开箱即用”，但非常灵活。
以 conda 为例（Ubuntu 24.04 默认不带其补全）：
- 先安装官方补全包：
conda install -c conda-forge conda-bash-completion - 补全脚本通常装在
$CONDA_PREFIX/etc/bash_completion.d/conda.sh，把它 source 进~/.bashrc：source "$CONDA_PREFIX/etc/bash_completion.d/conda.sh"
- 验证：输入
conda in<tab></tab>应该展开为conda install
如果你有个叫 mytool 的 Python CLI 工具，想让它支持子命令补全：
Ubuntu 26.04 LTS（代号“Resolute Raccoon”）是Canonical于2026年4月23日发布的下一代长期支持版操作系统，提供长达10年的技术支持。它搭载Linux 7.0内核与GNOME 50桌面环境，全面转向Wayland协议，并引入Rust重写的核心工具以增强安全性。官方提供适用于AMD64和ARM64架构的桌面及服务器ISO镜像，是追求前沿技术与极致稳定的开发者
- 写一个函数，例如：
_mytool_completion() { COMPREPLY=($(compgen -W "deploy rollback status logs" -- "${COMP_WORDS[1]}")) } - 注册它：
complete -F _mytool_completion mytool
- 把这两段加进
~/.bash_completion或~/.bashrc，然后source ~/.bashrc
注意：COMP_WORDS 是当前命令行拆分后的数组，${COMP_WORDS[1]} 就是第一个参数（即子命令），这样就能实现层级补全。
Zsh 用户别直接套用 bash-completion 配置
很多人在 Ubuntu 上切到 Zsh 后，照搬 Bash 的 bash-completion 配置，结果补全失效。Zsh 用的是完全不同的机制。
- Zsh 原生补全靠
compinit，不是complete命令 - Oh My Zsh 的
plugins=(git)只启用基础 Git 补全；要支持conda，得额外加插件：plugins=(git conda)，并确保conda init zsh已执行过 - Zsh 的第三方补全（如
zsh-autosuggestions）和bash-completion互不兼容 —— 别在 Zsh 里source /etc/bash_completion，会报错 - 如果坚持用 Zsh 但想兼容部分 bash 补全脚本，可用
zsh-bash-compdef工具桥接，但性能有损耗，不推荐日常使用
Terminator 中补全延迟或失效的排查重点
Terminator 是终端复用器，它本身不处理补全逻辑，但它的会话管理方式会影响补全行为。
- 新标签页默认是 non-login shell，
~/.bashrc加载不完整 —— 在 Terminator 设置里勾选 “Run command as login shell”（路径：Preferences → Profiles → Command） - 补全候选列表偶尔卡顿 100ms 左右？这是 Terminator 的渲染延迟，不是补全慢；可临时用
Ctrl+L刷新界面 - 广播输入（Broadcast）模式下按 Tab，所有窗口同时触发补全 —— 容易误操作，建议只在单窗口调试时开启
- 如果用了
tmux嵌套在 Terminator 里，补全失效大概率是因为 tmux 拦截了 Tab 键 —— 在~/.tmux.conf中加：set -g terminal-overrides 'xterm*:smkx@'
真正难调的不是怎么写补全函数，而是搞清当前环境到底跑的是哪个 shell、加载了哪些配置、补全请求最终落到哪一层 —— 多用 complete -p 和 echo $SHELL 确认现状，比盲目改配置更省时间。
