VS Server远程隧道无法连接故障求助

问题现象 #

• Mac端VS Code连接笔记本端开启的远程隧道时，隧道显示在线，弹出多条连接通知后报错
• 两台设备VS Code均已更新至最新版本
• 浏览器连接远程时同样报错
• 隧道输出日志存在连接异常提示

排查与解决步骤 #

1. 重启远程隧道 #

在笔记本端VS Code打开命令面板（Cmd/Ctrl+Shift+P），依次执行：

• Remote Tunnels: Stop Tunnel，等待隧道完全停止
• Remote Tunnels: Start Tunnel，重新启动隧道后再尝试连接

2. 清理远程扩展缓存 #

关闭两台设备的VS Code，分别清理对应缓存目录：

• Mac端：执行终端命令

  rm -rf ~/Library/Application\ Support/Code/User/globalStorage/ms-vscode.remote-explorer
  

• Windows笔记本端：执行PowerShell命令

  Remove-Item -Recurse -Force $env:APPDATA\Code\User\globalStorage\ms-vscode.remote-explorer
  

清理完成后重新启动VS Code，尝试连接隧道。

3. 检查网络与防火墙 #

• 确保两台设备处于同一稳定网络环境，切换至同一WiFi测试
• 临时关闭笔记本端防火墙，确认是否是防火墙拦截了隧道连接
• 关闭Mac端的代理软件（如VPN、科学上网工具），重试连接

4. 重新登录VS Code账户 #

在两台设备的VS Code中，打开命令面板执行Remote Tunnels: Sign Out，重新登录同一微软账户后，重启隧道并连接。

5. 查看详细日志定位问题 #

在Mac端VS Code打开命令面板，执行Developer: Toggle Logs，选择Remote Tunnels日志，查看具体报错信息（如认证失败、网络超时、端口占用等），根据日志提示针对性处理。

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