Mac系统下VS Code无法通过SSH连接GCP远程VM如何排查解决
VS Code远程连接GCP Debian实例报错解决方案
你可以依次尝试以下操作排查解决:
- 首先确认Remote-SSH插件版本和VS Code版本兼容:你使用的1.56.1版本VS Code属于较老版本,不要安装最新版Remote-SSH插件,需安装适配的0.65.x版本插件。可在插件市场找到Remote-SSH,点击「安装另一个版本」选择对应版本安装后重启VS Code。
- 配置本地SSH config文件简化连接逻辑,打开本地
~/.ssh/config文件,添加如下配置:
Host gcp-debian HostName 你的实例公网IP地址 User 实例登录用户名 IdentityFile ~/.ssh/你的私钥文件名 IdentitiesOnly yes
配置完成后在VS Code Remote-SSH的连接选项中直接选择gcp-debian即可,无需手动输入完整SSH命令。
- 检查本地私钥权限:Mac系统下私钥文件权限过高会导致SSH连接校验失败,执行以下命令修正权限:
chmod 700 ~/.ssh chmod 600 ~/.ssh/你的私钥文件名
- 清理远程实例的VS Code服务端缓存:手动通过SSH命令连接到实例后,执行以下命令删除旧的服务端文件,下次连接时VS Code会自动重新安装适配版本的服务端:
rm -rf ~/.vscode-server
- 安装远程实例必要依赖:连接到实例后执行以下命令安装VS Code服务端运行所需的依赖包:
sudo apt update && sudo apt install -y wget curl libssl1.1 build-essential
- 关闭Remote-SSH的Control Master配置:打开VS Code设置,搜索
Remote.SSH: Enable Control Master,取消勾选该选项后重试连接。
内容的提问来源于stack exchange,提问作者user1403505
相关产品推荐
相关产品推荐

