iTerm2 3.0.15 beta（Sierra系统）Shell Integration失效求助

我之前在旧系统折腾iTerm2时也碰到过一模一样的Shell Integration失效情况，结合你的环境（Sierra系统 + iTerm2 3.0.15 beta），给你整理几个针对性的排查步骤，亲测大部分情况都能解决：

1. 先确认Shell Integration脚本是否正常加载 #

打开你的bash终端，输入这条命令：

echo $ITERM_SHELL_INTEGRATION_INSTALLED

如果输出不是Yes，说明系统根本没加载iTerm2的Shell Integration脚本。这时候要检查你的bash配置文件（~/.bash_profile或~/.bashrc）里有没有这行加载代码：

test -e "${HOME}/.iterm2_shell_integration.bash" && source "${HOME}/.iterm2_shell_integration.bash"

如果没有，直接在iTerm2顶部菜单选 iTerm2 > Install Shell Integration 重新安装一遍，安装后会自动把加载代码写入配置文件。

2. 检查脚本文件是否损坏或丢失 #

先看看脚本文件还在不在：

ls ~/.iterm2_shell_integration.bash

如果提示文件不存在，直接重新安装Shell Integration就行。如果文件存在，可能是脚本损坏了，先备份再替换：

mv ~/.iterm2_shell_integration.bash ~/.iterm2_shell_integration.bash.bak

然后重新安装Shell Integration，让系统生成新的脚本文件。

3. 排查bash配置的冲突问题 #

很多时候是自定义的bash配置覆盖了iTerm2的设置：

• 检查你的.bash_profile或.bashrc里有没有修改PS1提示符的代码，确保iTerm2的加载脚本放在文件最后一行——这样就不会被后续的PS1设置覆盖掉提示符前的标记。
• 可以临时禁用所有自定义配置：把.bash_profile重命名为.bash_profile.bak，然后重启iTerm2。如果Shell Integration恢复了，再逐行排查配置文件里哪段代码导致了冲突。

4. 针对beta版本的特殊处理 #

3.0.15 beta属于测试版，可能存在兼容性bug：

• 先备份你的iTerm2配置（iTerm2 > Preferences > General > Preferences > Save Settings to Folder），然后重置偏好设置：

defaults delete com.googlecode.iterm2

重启iTerm2后重新配置Shell Integration，看是否恢复正常。

• 如果重置后还是不行，可以暂时切换到iTerm2的稳定版，beta版本偶尔会出现和旧系统（比如Sierra）的兼容性问题。

5. 检查Toolbelt和终端配置 #

• 打开iTerm2偏好设置，进入Profiles > General > Command，确保选择的是Login shell而不是Command——如果选了Command，终端不会加载登录脚本，自然也启动不了Shell Integration。
• 打开Toolbelt（点击iTerm2窗口右上角的小图标），确认Command History、Recent Directories这些选项是勾选状态，有时候可能不小心误关了这些功能。

如果以上步骤都试过还是没解决，可以新建一个系统测试用户，在新用户环境下安装Shell Integration测试。如果新用户能正常使用，说明是当前用户的配置文件或权限有问题。

内容的提问来源于stack exchange，提问作者76 Pinto