iTerm2与oh-my-zsh：远程主机的oh-my-zsh为何覆盖iTerm2标签标题？

核心原因 #

远程主机的oh-my-zsh默认启用了自动终端标题设置功能，会在shell初始化和每次命令执行后重置标题，直接覆盖iTerm2在SSH连接过程中设置的远程主机名标题。

解决方案 #

1. 禁用远程oh-my-zsh的自动标题功能 #

编辑远程主机的~/.zshrc配置文件：

vim ~/.zshrc

找到或添加以下配置：

DISABLE_AUTO_TITLE="true"

保存退出后，重新加载配置使修改生效：

source ~/.zshrc

此操作会关闭远程oh-my-zsh的自动标题修改逻辑，iTerm2设置的SSH主机名标题将被保留。

2. 自定义远程主机的终端标题（可选） #

如果希望远程shell显示特定标题（比如用户名+主机名），同时不与iTerm2的设置冲突，可以在远程~/.zshrc中添加自定义标题逻辑：

precmd() {
  # 设置标签标题为「用户名@主机名」
  echo -ne "\e]1;${USER}@${HOSTNAME}\a"
  # 若需同时修改窗口标题，可添加下方注释行
  # echo -ne "\e]2;${USER}@${HOSTNAME}\a"
}

precmd函数会在每次命令执行完毕、显示新提示符前运行，确保标题稳定显示自定义内容。

3. 排查本地oh-my-zsh的SSH相关配置 #

若上述方法无效，检查本地~/.zshrc中是否存在SSH相关的标题修改逻辑（比如自定义的ssh别名、函数）。例如部分用户会设置：

ssh() {
  echo -ne "\e]1;$1\a"
  command ssh "$@"
}

这种本地设置会在SSH连接时修改标题，但远程oh-my-zsh的自动标题功能会覆盖它。此时可调整本地逻辑，或确保远程的DISABLE_AUTO_TITLE配置已正确开启。

内容的提问来源于stack exchange，提问作者Jeff Templon