complete命令不生效，通常是因为bash-completion没有正确加载：Terminator 默认启动的是非登录 shell，不会自动 source 补全脚本；因此需要先确认shopt login_shell显示为 off，再检查~/.bashrc中是否包含正确的 source 语句，执行source ~/.bashrc后，再通过complete -p验证补全函数是否已经成功加载。

为什么complete命令不生效？先确认 Bash 补全系统是否已加载

很多人在运行complete -p | grep git后发现没有任何输出，第一反应往往是终端自动补全功能“坏了”。但大多数情况下，问题并不在补全规则本身，而是bash-completion根本没有被加载。原因很常见：Terminator 默认启动的是非登录 shell，在这种模式下，系统通常不会自动 source /etc/bash_completion或~/.bash_completion。

排查方法很简单：在 Terminator 中执行shopt login_shell，如果输出结果是login_shell off，就说明当前 shell 没有经过完整的初始化加载流程。

• 打开~/.bashrc，确认文件末尾存在这段内容，并且没有被注释掉：

  if ! shopt -oq posix; thennif [ -f /usr/share/bash-completion/bash_completion ]; thenn. /usr/share/bash-completion/bash_completionnelif [ -f /etc/bash_completion ]; thenn. /etc/bash_completionnfinfi

• 修改完成后务必执行source ~/.bashrc，否则新的 Bash 补全配置不会立即生效
• 再使用complete -p | head -5检查输出中是否出现大量_git、_docker之类的补全函数名

如何为自定义脚本或内部工具添加命令自动补全规则

例如你有一个名为deploy-cli的 Python 脚本，放在/usr/local/bin/目录下，希望它支持像deploy-cli deploy --env 这样的环境名自动补全，那么就不能只依赖默认补全规则，而需要手动为这个命令注册 Bash 补全函数。

核心要点是：补全函数名称必须遵循_命令名这种格式，并且函数内部要通过COMPREPLY数组返回候选项。

• 可以在~/.bash_completion中加入：

  _deploy_cli() {nlocal cur="${COMP_WORDS[COMP_CWORD]}"ncase ${COMP_WORDS[COMP_CWORD-1]} inn--env)nCOMPREPLY=("prod" "staging" "dev")nreturnn;;nesacn}ncomplete -F _deploy_cli deploy-cli

• COMP_WORDS表示当前命令被拆分后的参数数组，COMP_CWORD表示当前光标所在单词的索引位置
• 不要使用echo输出候选内容，必须把结果赋值给COMPREPLY，否则 Tab 补全不会显示
• 写完之后记得执行source ~/.bash_completion，或者重新打开一个 Terminator 标签页进行测试

补全插件选项冲突：比如zsh-autosuggestions和bash-completion能共存吗

严格来说，不能混为一谈，很多用户都会在这里踩坑：看到 Zsh 插件名里有“autosuggestions”，就误以为它和 Bash 里的 bash-completion属于同一种终端补全机制。实际上，这两者功能完全不同。zsh-autosuggestions负责的是基于历史命令前缀的输入提示，也就是你打字时后面出现的灰色建议；它并不处理按下 Tab 之后的上下文补全。相比之下，bash-completion专门处理的正是 Tab 键命令补全，因此实现机制与前者完全不同。

如果你在 Terminator 中使用的是 Bash（默认情况），安装zsh-autosuggestions并不会生效；反过来，如果你已经切换到了 Zsh，再去安装bash-completion也不会起作用。

• 先检查当前 shell：执行ps -p $$，查看输出中是bash还是zsh
• Bash 用户只需要配置bash-completion，而 Zsh 用户更适合使用zsh-autosuggestions + zsh-completions
• 如果混用不同 shell 的补全插件，可能会导致complete命令报错，或者 Tab 键没有任何响应

多会话下补全失效：为什么新打开的Terminator窗口不继承补全规则

这是因为每个 Terminator 标签页或面板，本质上都是独立启动的 Bash 进程。它们会分别读取~/.bashrc，但不会自动共享已经注册好的complete规则。如果你只是在某一个标签页里手动执行了complete -F _myfunc mycmd，那么其他标签页是无法看到这个补全规则的。

更稳妥、也更推荐的做法，是把所有补全逻辑统一写入~/.bash_completion，并确保该文件会被~/.bashrc正确加载，而不是只在当前终端会话里临时注册命令补全。

• ~/.bash_completion本身就是为 Bash 自动补全设计的加载入口，终端启动时会识别并执行其中的complete调用
• 尽量避免只在交互式 shell 中直接运行complete命令，因为这种方式通常只对当前会话有效
• 如果使用了 Terminator 的广播输入功能，更要确保所有会话都从同一份补全配置中加载，否则不同窗口的补全行为会不一致