VS Code远程开发需本地SSH配置、服务器环境和Remote-SSH扩展三者对齐；先确保终端ssh直连成功，检查~/.ssh/config拼写与私钥权限，服务器须有bash、/tmp可写且~/.vscode-server部署路径无权限限制。
VS Code 的远程开发（Remote - SSH）不是“连上就行”，关键在于本地 SSH 配置、服务器环境和 VS Code 扩展三者必须对齐，缺一不可。多数连接失败不是因为操作步骤错，而是某处配置没生效或权限被静默拒绝。
确保本地 ssh 命令能直连服务器
VS Code 的 Remote - SSH 本质是调用你系统里的 ssh 命令，它不自带 SSH 客户端。如果终端里 ssh user@host 都通不过，VS Code 必然失败。
- 先在终端运行
ssh -T user@host，确认能成功登录并看到欢迎信息 - 检查
~/.ssh/config是否有拼写错误，比如把HostName写成Hostname（大小写敏感） - 若用密钥登录，确认私钥权限是
600：chmod 600 ~/.ssh/id_rsa - Windows 用户注意：WSL 和 PowerShell 的
ssh配置不互通，VS Code 默认走系统 PATH，要确认它调用的是你期望的那个ssh
安装 Remote - SSH 扩展后，Remote-SSH: Connect to Host... 没反应或报错
扩展本身不处理认证逻辑，只负责转发连接请求。常见静默失败原因集中在服务器端缺少必要组件或路径异常。
- 服务器上必须有
bash（或sh），且在$PATH中；某些精简版 Linux（如 Alpine）默认没有bash，需手动安装 - VS Code 会在服务器用户家目录下自动部署服务端（
~/.vscode-server），如果磁盘满、权限不足（比如/home是 noexec 挂载）、或 SELinux 启用，部署会失败且只显示“Failed to connect” - 可手动触发部署：在服务器上运行
curl -fsSL https://aka.ms/vscode-remote-sh | sh，再看输出是否报错 - 检查服务器的
/tmp是否可写——VS Code 临时解压依赖时会用到它
连接成功但打开文件夹后提示 Command 'Developer: Toggle Developer Tools' resulted in an error
这不是连接问题，而是 VS Code 尝试在远程环境中加载本地插件导致的兼容性冲突。远程开发要求插件明确声明支持“Server-side”运行。
- 禁用所有本地启用的插件：在 VS Code 窗口右下角点击 “Remote [SSH]”，选择
Disable All Installed Extensions - 只启用标有
Remote或SSH兼容标识的插件（比如Python扩展需开启“Install on SSH: xxx”） - 编辑器设置（
settings.json）中避免写死本地路径，例如"python.defaultInterpreterPath"应设为远程路径，如"/usr/bin/python3" - 终端里执行
code --list-extensions，确认返回的是远程服务器上的扩展列表，而不是本地的
最常被忽略的一点：VS Code 的 Remote - SSH 不会自动同步你的 shell 配置（如 ~/.bashrc 中的 export PATH）。如果服务器上工具装在非标准路径（比如 /opt/python3.11/bin），VS Code 的集成终端可能找不到，但你在 SSH 终端里却可以——这是因为 VS Code 启动时未 source 这些文件。需要在 ~/.bashrc 开头加一句 if [ -n "$VSCODE_PID" ]; then return; fi 并确保 ~/.profile 或 /etc/profile 正确加载了它。
