vs code远程开发需精准配置remote-ssh扩展及ssh参数。仅安装remote-ssh，禁用其他remote扩展；确保vs code为稳定版；~/.ssh/config中host、hostname、user、identityfile和identitiesonly必须正确；连接失败多因vscode-server未启动、磁盘满或selinux限制。
VS Code 的远程开发不是“连上就能用”，关键在 Remote-SSH 扩展的配置是否精准匹配目标服务器环境。配错一个字段，Failed to fetch remote environment 或 Permission denied (publickey) 就会卡住你半小时。
装对扩展：只装 Remote-SSH，别碰 Remote-WSL 或 Remote-Containers
这三个扩展功能互不兼容，混用会导致连接后无法加载终端或文件树。你只是连 Linux 服务器，就只启用 Remote-SSH；它会自动拉起 vscode-server 后端进程，不需要手动上传或安装服务端二进制。
- 禁用其他 Remote 扩展，避免
vscode-server版本冲突 - 确认 VS Code 是稳定版（非 Insiders），Insiders 有时会向服务器推送不兼容的 server build
- 扩展安装后不用重启 VS Code，但首次连接会自动下载对应平台的
vscode-server
ssh config 文件必须写对 Host、User、HostName 和 IdentityFile
VS Code 的 Remote-SSH 完全依赖系统级 ~/.ssh/config，不读取命令行参数或弹窗输入的密码。填错任意一项，就会卡在 “Establishing connection…” 或报 Could not establish connection to …。
-
Host是你在 VS Code 里看到并选择的别名（如myserver），不能含空格或下划线 -
HostName必须是 IP 或可解析域名，不能写localhost（除非真在本地 SSH 到自己） -
IdentityFile要写绝对路径，比如/Users/you/.ssh/id_rsa，波浪号~不展开 - 加一行
IdentitiesOnly yes，防止 SSH 尝试用默认密钥反复失败
连接后打不开文件夹？检查 vscode-server 的权限和磁盘空间
连接成功但左侧资源管理器空白、终端显示 command not found: node 或 permission denied，大概率是 vscode-server 没跑起来，或者它解压到的目录不可写。
- 登录服务器后执行
ls -la ~/.vscode-server，确认目录存在且属主是你自己 - 如果
~/.vscode-server/bin/...下没子目录，说明下载中断了，删掉整个~/.vscode-server重试 -
df -h看/home或/tmp是否满——vscode-server默认解压到/tmp，满了就静默失败 - 某些服务器禁用了
~/.bashrc中的 PATH 扩展，导致node、python找不到，可在 VS Code 设置里加"remote.SSH.env": {"PATH": "/usr/local/bin:/usr/bin:/bin"}
最常被忽略的是 SSH agent 转发失效和 SELinux 限制。如果你用的是 CentOS/RHEL 服务器，setsebool -P ssh_sysadm_login on 可能才是连接后终端不启动的根本原因。
