若VSCode无法SSH连接远程服务器，需依次检查：一、确认服务器SSH服务运行状态；二、配置本地SSH密钥与known_hosts；三、安装启用Remote-SSH扩展并配置~/.ssh/config；四、根据具体错误码修复权限、目录权限或缺失依赖。
如果您希望在本地VSCode中编辑远程服务器上的代码，但无法建立SSH连接，则可能是由于SSH配置错误、服务器未启用SSH服务或网络不通。以下是解决此问题的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、确认远程服务器SSH服务状态
该方法用于验证目标服务器是否已正确安装并运行OpenSSH服务，确保基础连接通道可用。
1、通过终端执行命令 ssh -v user@server_ip，观察输出中是否出现 Connection refused 或 No route to host 等提示。
2、若提示连接被拒，在远程服务器上运行 sudo systemctl is-active ssh（Ubuntu/Debian）或 sudo systemctl is-active sshd（CentOS/RHEL），确认返回值为 active。
3、如服务未运行，执行 sudo systemctl start ssh 并设置开机自启：sudo systemctl enable ssh。
二、配置本地SSH密钥与known_hosts
该方法避免密码重复输入，并防止因主机密钥变更导致VSCode拒绝连接。
1、在本地终端执行 ssh-keygen -t ed25519 -C "your_email@example.com" 生成密钥对，默认保存于 ~/.ssh/id_ed25519。
2、将公钥复制到服务器：ssh-copy-id -i ~/.ssh/id_ed25519.pub user@server_ip。
3、手动检查 ~/.ssh/known_hosts 中是否已存在该服务器条目；若曾删除重装系统或更换IP，需删除对应行再重试连接。
三、安装并启用VSCode Remote-SSH扩展
该方法确保VSCode具备解析SSH配置并启动远程工作区的核心能力。
1、打开VSCode，在扩展面板中搜索 Remote - SSH，点击安装并重启VSCode。
2、按下 Cmd+Shift+P（Mac）调出命令面板，输入 Remote-SSH: Connect to Host... 并回车。
3、首次使用时选择 Configure SSH Hosts...，指定 ~/.ssh/config 文件路径，然后添加形如 Host myserver\n HostName 192.168.1.100\n User ubuntu 的配置段。
四、处理常见连接失败错误
该方法针对VSCode弹出具体错误码时的定向修复，覆盖典型故障场景。
1、若报错 Could not establish connection to "xxx": Permission denied (publickey)，需在 ~/.ssh/config 中显式添加 IdentityFile ~/.ssh/id_ed25519 行。
2、若报错 Failed to fetch remote environment，说明VSCode尝试在远程执行脚本失败，可手动在服务器上运行 mkdir -p ~/.vscode-server 并确认用户对该目录有完整读写权限。
3、若连接后文件浏览器为空，检查远程服务器是否安装了 curl 或 wget，VSCode依赖其下载服务端组件；缺失时执行 sudo apt install curl（Ubuntu）或 sudo yum install curl（CentOS）。
