如何让VS Code的SSH远程会话同步Windows虚拟机的环境变量？

问题背景 #

通过VS Code Remote-SSH连接Windows Hyper-V虚拟机时，SSH会话的PATH环境变量缺失本地已配置的Python路径，导致无法执行Python相关操作，直接SSH连接也存在同样问题。

解决方案 #

1. 调整OpenSSH Server启动时机 #

Windows OpenSSH Server默认启动较早，可能未等待系统环境变量完全加载：

• 打开服务管理器（运行services.msc）
• 找到OpenSSH SSH Server服务，右键选择「属性」
• 将启动类型改为「自动（延迟启动）」
• 重启服务，让服务在系统环境加载完成后启动

2. 配置PowerShell用户Profile自动加载环境变量 #

SSH默认使用非交互式PowerShell，不会自动加载用户Profile，手动添加环境变量加载逻辑：

1. 远程登录虚拟机，打开PowerShell执行：

   # 若Profile文件不存在则创建
   if (!(Test-Path $PROFILE)) { New-Item -Path $PROFILE -ItemType File -Force }
   # 打开Profile文件编辑
   notepad $PROFILE
   

2. 在打开的文件中添加以下内容，合并系统与用户的PATH：

   # 加载系统和用户级PATH到当前会话
   $env:PATH = [System.Environment]::GetEnvironmentVariable("PATH","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("PATH","User")
   

3. 保存文件后，下次SSH登录时PowerShell会自动执行该脚本，补全环境变量

3. 通过OpenSSH全局配置加载环境变量 #

修改OpenSSH Server配置，允许加载用户自定义环境变量：

1. 以管理员权限打开C:\ProgramData\ssh\sshd_config文件
2. 找到PermitUserEnvironment项，去掉注释并设置为：

   PermitUserEnvironment yes
   

3. 在用户目录下创建C:\Users\kusha\.ssh\environment文件（无扩展名），添加Python路径到PATH：

   PATH=C:\Users\kusha\AppData\Local\Programs\Python\Python313\Scripts\;C:\Users\kusha\AppData\Local\Programs\Python\Python313\;C:\Users\kusha\AppData\Local\Programs\Python\Launcher\;%PATH%
   

4. 重启OpenSSH Server服务，所有SSH会话将自动加载该配置

4. VS Code Remote专属配置（可选） #

如果以上方法仍未生效，可在VS Code远程设置中强制加载环境：

• 按Ctrl+Shift+P打开命令面板，选择「Remote-SSH: Open Remote Settings」
• 添加以下配置到远程设置文件：

  "terminal.integrated.profiles.windows": {
      "PowerShell": {
          "source": "PowerShell",
          "args": ["-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", "& { $env:PATH = [System.Environment]::GetEnvironmentVariable('PATH','Machine') + ';' + [System.Environment]::GetEnvironmentVariable('PATH','User'); Invoke-Expression $PROFILE }"]
      }
  },
  "terminal.integrated.defaultProfile.windows": "PowerShell"
  

原因说明 #

Windows OpenSSH Server默认启动优先级较高，可能在系统环境变量完全初始化前启动；同时，SSH会话默认使用非交互式PowerShell，不会自动加载用户Profile文件，导致会话环境与本地登录环境不一致。

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