VSCode SSH远程连接异常：useLocalServer配置不生效求助

以下是几个可以强制远程扩展遵循本地用户设置的方法，按步骤操作即可：

• 清除本地特定主机的SSH缓存
  VSCode会将每个远程主机的配置缓存到本地目录，找到对应路径删除目标主机的缓存文件：

  • Windows：%APPDATA%\Code\User\globalStorage\ms-vscode-remote.remote-ssh\hosts
  • macOS/Linux：~/.config/Code/User/globalStorage/ms-vscode-remote.remote-ssh/hosts
    找到对应出问题的主机名文件直接删除，下次连接时VSCode会重新读取本地用户设置。

• 重置远程服务器的VSCode Server
  远程端的.vscode-server可能残留旧配置缓存，登录远程主机后执行：

  rm -rf ~/.vscode-server
  

  重新连接时VSCode会自动重装干净的Server环境，不会再加载旧配置。

• 强制指定配置优先级

  1. 打开本地用户设置JSON（按Ctrl+Shift+P，输入Open User Settings (JSON)），确认或添加：

     "remote.SSH.useLocalServer": false
     

  2. 可以针对目标主机单独锁定配置，在同一文件中添加：

     "[remote-ssh://你的远程主机名/]" : {
         "remote.SSH.useLocalServer": false
     }
     

     这样能确保该主机优先使用此设置，不受其他缓存干扰。

• 彻底重启VSCode
  完全关闭VSCode（包括后台运行的进程），重新打开后再尝试连接目标主机，此时会严格遵循本地配置。

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