Ubuntu如何设置具体的命令行自动补全插件

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 应该展开为 conda install

如果你有个叫 mytool 的 Python CLI 工具，想让它支持子命令补全：

• 写一个函数，例如：

  _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 确认现状，比盲目改配置更省时间。