macOS下VSCode Remote SSH需删除.vscode-server才能连接的故障求助

针对你遇到的「不删除远程.vscode-server文件夹就无法连接，报错Failed to parse remote port from server output」问题，以下是几个无需手动频繁删除文件的长期解决方案：

1. 自动清理冲突文件（直接替代手动删除） #

在本地~/.ssh/config中为lxplus主机添加自动清理逻辑，每次连接时自动删除有问题的extensions.json：

Host lxplus.cern.ch
  HostName lxplus.cern.ch
  User <你的用户名>
  RemoteCommand rm -f ~/.vscode-server/extensions.json && exec $SHELL
  RequestTTY yes

保存配置后重新连接，VSCode会自动重新生成合法的extensions.json，无需手动操作。

2. 强制终止远程残留的VSCode服务进程 #

打开本地VSCode的命令面板（Cmd+Shift+P），执行：
Remote-SSH: Kill VS Code Server on Host...
选择lxplus.cern.ch后再重新发起连接。该操作会清理远程端残留的异常服务进程，解决端口占用或进程崩溃导致的解析失败问题。

3. 修复远程.vscode-server目录权限 #

远程端的权限异常可能导致VSCode无法正确读写扩展配置文件，执行以下命令修复：

chown -R $USER:$USER ~/.vscode-server
chmod 700 ~/.vscode-server
chmod 600 ~/.vscode-server/extensions.json

设置后确保只有你的用户能访问该目录及文件，避免权限冲突引发的解析错误。

4. 禁用远程扩展自动同步 #

打开VSCode设置（Cmd+,），搜索并修改以下配置：

• 将remote.SSH.syncExtensions设置为false
• 清空remote.SSH.defaultExtensions列表
  该操作会阻止VSCode自动同步本地扩展到远程，从根源避免因扩展版本不兼容、安装失败导致的extensions.json损坏问题。

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