VSCode Remote-SSH 连接失败需先确保终端 ssh 命令直连成功；配置中 HostName 和 IdentityFile 必须用绝对路径；远程需预留空间并具备 curl/tar/glibc 等依赖；文件卡顿可禁用 file watching。
VSCode 连不上远程主机？先确认 ssh 命令能否在终端直连
VSCode 的 Remote-SSH 扩展本质是调用本地系统的 ssh 命令，不是自己实现 SSH 协议。如果终端里执行 ssh user@host 都失败，VSCode 一定连不上。
常见卡点：
-
Permission denied (publickey)：说明密钥没配对或权限不对（~/.ssh/id_rsa和~/.ssh/id_rsa.pub需要 600 / 644 权限） -
Connection refused：远程主机的sshd没启动，或防火墙拦了 22 端口 -
No route to host：网络不通，比如本地连的是公司内网，但目标主机在另一套 VPC 里
务必先在终端跑通：
ssh -i ~/.ssh/mykey user@192.168.1.100 -p 2222再进 VSCode。
Remote-SSH 配置文件里 HostName 和 IdentityFile 必须写绝对路径
VSCode 不会自动展开 ~ 或环境变量，IdentityFile ~/.ssh/id_rsa 会被当成字面量解析，导致认证失败。
正确写法（Linux/macOS）：
Host myserver HostName 192.168.1.100 User ubuntu Port 2222 IdentityFile /home/you/.ssh/id_rsa ForwardAgent yes
Windows 上路径用正斜杠或双反斜杠：IdentityFile C:/Users/You/.ssh/id_rsa 或 IdentityFile C:\Users\You\.ssh\id_rsa。
其他易错点：
-
Host别名不能含空格、下划线，推荐纯字母+数字 - 配置文件路径必须是
~/.ssh/config（macOS/Linux）或%USERPROFILE%.sshconfig（Windows），VSCode 不读其他位置 - 改完 config 后不用重启 VSCode，但需重新触发连接（比如点击左下角远程按钮 → “Connect to Host…”）
第一次连接时 VSCode 自动安装 vscode-server 失败？检查远程磁盘空间和 Python 环境
VSCode 在远程主机上需要部署一个轻量服务端（vscode-server），它依赖远程机器有基础运行环境。常见失败原因：
- 远程
/tmp目录满（df -h /tmp查看），vscode-server默认解压到那里 - 远程没有
curl或wget，无法下载服务端包 - 某些精简版 Linux（如 Alpine）缺
glibc或tar，导致解压失败 - 远程
$HOME所在分区只剩几百 MB，安装中途报 “No space left on device”
手动预装方式（可绕过自动流程）：
ssh user@host mkdir -p ~/.vscode-server/bin cd ~/.vscode-server/bin # 从 VSCode GUI 左下角 “Remote-SSH: Show Log” 里复制实际要下载的 commit ID，例如： wget https://update.code.visualstudio.com/commit:abcd1234.../server-linux-x64/stable -O vscode-server.tar.gz tar -xzf vscode-server.tar.gz --strip-components=1
连接后打开文件慢、编辑卡顿？关掉远程端的 file watching
VSCode 默认在远程启用文件系统监听（用于自动刷新、保存后触发构建等），但通过 SSHFS 或低带宽链路访问时，inotify 事件频繁往返会拖慢响应。
解决方法：在远程主机的 ~/.vscode-server/data/Machine/settings.json（或用户级 settings.json）中加：
{
"files.watcherExclude": {
"**/.git/objects/**": true,
"**/node_modules/**": true,
"/var/log/**": true
},
"files.useExperimentalFileWatcher": false
}注意：files.useExperimentalFileWatcher 设为 false 会禁用基于 inotify 的监听，改用轮询（CPU 略高但更稳）；若远程是 NFS 或容器挂载卷，这是必选项。
远程开发真正的门槛不在连接本身，而在理解 VSCode 是如何把本地 UI 和远程进程拆开协作的——一旦你开始调试 vscode-server 日志、手动传二进制、或给不同发行版打补丁，就真正跨过了“能连”和“好用”的分界线。
