zsh中ssh命令补全内容来源排查：非配置域名自动补全问题

当你输入ssh ar<TAB>时，补全出未在~/.ssh/config中定义的ari.sweedler.com，大概率是系统补全逻辑的优先级或来源问题，以下是具体排查方向和修复方案：

1. 系统域名后缀自动补全在起作用 #

如果系统配置了域名搜索后缀（比如sweedler.com），输入ar时会自动匹配该域下的有效主机名。

• 排查：查看/etc/resolv.conf，检查是否有search sweedler.com这类配置；执行host ari.sweedler.com确认该域名能被系统解析。
• 修复：
  • 若不需要该后缀补全，修改/etc/resolv.conf（注意部分系统由NetworkManager等工具动态生成，需通过对应工具修改），移除或调整search字段。
  • 也可以在~/.ssh/config中添加空配置条目，强制ssh补全优先识别它：

    Host ari.sweedler.com
        # 无需额外配置，仅用于提升补全优先级
    

2. SSH补全脚本的优先级设置 #

不同shell（bash/zsh）的ssh补全脚本会从多个来源（~/.ssh/config、known_hosts、系统主机解析）获取候选，若系统解析的来源优先级更高，就会出现这种情况。

• 排查：
  • bash：查看/etc/bash_completion.d/ssh或~/.bash_completion.d/ssh中的补全逻辑，确认是否先读取系统主机再读取config条目。
  • zsh：若用oh-my-zsh，检查~/.zshrc是否加载了ssh插件，查看插件代码里的补全顺序。
• 修复：
  • 修改补全脚本，将~/.ssh/config中的主机列表放在系统主机列表前面。比如bash补全脚本中，调整候选数组的拼接顺序。
  • zsh用户可修改ssh插件的补全逻辑，优先读取config内的主机条目。

3. ~/.ssh/known_hosts存在该域名记录 #

如果之前通过ssh连接过ari.sweedler.com，该域名会被写入~/.ssh/known_hosts，部分补全脚本会优先从这里读取候选。

• 排查：执行grep "ari.sweedler.com" ~/.ssh/known_hosts，确认记录存在。
• 修复：
  • 若不需要保留该记录，直接删除known_hosts中对应的行。
  • 或者调整补全脚本，让~/.ssh/config的条目优先级高于known_hosts。

4. 其他本地主机配置文件影响 #

系统可能从/etc/hosts或自定义主机文件读取候选：

• 排查：检查/etc/hosts是否有ari.sweedler.com的映射；执行echo $HOSTFILE确认是否设置了自定义主机文件路径。
• 修复：
  • 若/etc/hosts中有该条目，删除或注释掉即可。
  • 若设置了HOSTFILE，调整对应文件内容或取消该环境变量。

内容的提问来源于stack exchange，提问作者Ari Sweedler