VSCode Git扩展：通过Remote SSH连接服务器需每次重启终端求解决

问题现象 #

每次通过Remote SSH连接服务器时，都会弹出如下提示：

重启终端后警告消失，但下次SSH连接时仍会重复出现。

问题根源 #

核心原因是Git的环境变量未在SSH初始会话中正确加载，常见触发场景有两种：

1. Git的路径配置（如PATH变量）仅写在.bashrc、.zshrc这类交互式shell配置文件中，但SSH默认启动的是非交互式shell，不会自动加载这些文件，导致系统无法识别Git，触发"需重启终端加载环境变量"的提示。
2. Git安装脚本在配置文件中添加了环境变量初始化代码，但该代码仅在新会话启动时生效，SSH首次连接的会话未同步到最新配置。

彻底解决方法 #

根据使用的shell类型，选择对应方案：

方案1：将Git配置移到SSH会加载的文件中 #

• 若用Bash：编辑~/.bash_profile（或~/.profile），添加Git路径到环境变量：

  # 替换为你的Git实际安装路径
  export PATH="/usr/local/git/bin:$PATH"
  

• 若用Zsh：编辑~/.zprofile，添加同样的路径配置。

方案2：让非交互式shell加载交互式配置 #

• Bash用户在~/.bash_profile中添加：

  if [ -f ~/.bashrc ]; then
    source ~/.bashrc
  fi
  

• Zsh用户在~/.zprofile中添加：

  if [ -f ~/.zshrc ]; then
    source ~/.zshrc
  fi
  

方案3：清理Git安装残留的提示代码 #

部分Git安装程序会在.bashrc/.zshrc中添加临时提示语句，找到并删除类似内容：

echo "请重启终端以完成Git配置"

验证方式 #

修改配置后断开SSH连接，重新登录服务器，检查是否仍弹出提示。也可执行echo $PATH确认Git路径已在环境变量中，执行git --version验证Git能正常调用。

内容的提问来源于stack exchange，提问作者Amir Valizadeh