VSCode Remote-SSH 连接失败主因是 SSH 基础不通、vscode-server 部署失败或本地远程用户权限不一致；须先确保命令行 ssh 免密可达，再检查远程依赖与权限。
VSCode 的远程开发（Remote-SSH）不是“装个插件就能连”，关键在 ssh 基础通、vscode-server 自动部署是否成功、以及本地与远程用户权限是否一致。多数连不上，问题出在 SSH 配置或远程环境缺失依赖，而不是 VSCode 设置本身。
确保本地能用命令行 ssh 连上目标机器
这是 Remote-SSH 能工作的前提。VSCode 本质是调用你系统里的 ssh 命令，不是自己实现 SSH 协议。
- 在终端运行
ssh user@host，必须能免密登录（推荐配置~/.ssh/config），且不报Permission denied (publickey)或Connection refused - 如果用密码登录，Remote-SSH 会弹窗要求输密码；但某些服务器禁用密码登录（
PasswordAuthentication no），此时必须配好公钥 - 检查远程机器是否运行了 SSH 服务：
systemctl is-active sshd（Linux）或sudo launchctl list | grep ssh（macOS） - Windows 远程需启用 OpenSSH Server（设置 → 应用 → 可选功能 → 添加 “OpenSSH 服务器”），并确认服务已启动
安装 Remote-SSH 插件并触发自动部署
插件本身不包含远程端逻辑，它会在首次连接时，通过 SSH 把 vscode-server 二进制推到远程 ~/.vscode-server 并启动。
- 在 VSCode 扩展市场搜
Remote - SSH，安装官方插件（作者 Microsoft） - 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Remote-SSH: Connect to Host... - 选择已有 host（来自
~/.ssh/config）或输入user@host；第一次连接会卡在 “Installing VS Code Server” —— 这是在上传和解压，别关窗口 - 若卡住或报错
Failed to download vscode-server，大概率是远程机器无法访问 GitHub 或 npmjs.org（国内常见）；可手动下载对应 commit 的vscode-server-linux-x64.tar.gz，传到远程~/.vscode-server/bin/xxx...目录并解压
远程环境缺少依赖导致 server 启动失败
vscode-server 启动需要基础工具链，尤其在最小化安装的 Linux（如 Alpine、Ubuntu Server）上容易缺库。
- 常见错误日志出现在 VSCode 输出面板 → 选择 “Remote Server”：出现
libX11.so.6: cannot open shared object file或GLIBC_2.29 not found - Ubuntu/Debian 上运行：
sudo apt update && sudo apt install -y libx11-6 libglib2.0-0 libglib2.0-dev libgtk-3-0 libnss3 libc6-dev
- CentOS/RHEL：
sudo yum install -y libX11 glib2 gtk3 nss
（或dnf） - Alpine 用户需换用
vscode-server-alpine版本（插件会自动选，但有时需手动指定）；也可改用完整镜像，避免折腾
连接后打开文件夹权限被拒绝或 Git 不工作
VSCode 远程会以你 SSH 登录的用户身份运行所有进程，但该用户可能没权限读写目标路径，或没配置 Git 凭据。
- 不要用
sudo code .连接 —— 这会让vscode-server以 root 运行，后续扩展安装、Git 操作全乱套 - 确保你要打开的目录对当前用户有读写权限：
ls -ld /path/to/project，必要时chown -R $USER:$USER /path/to/project - Git 提交报
unable to read askpass response：在远程执行git config --global core.askpass ""，或在 VSCode 设置里关掉git.useIntegratedAskPass - 如果远程是容器或受限环境，
~/.vscode-server可能被挂载为只读；换用code --remote ssh-remote+host /path并指定--skip-server-setup手动控制
真正麻烦的从来不是“怎么点开 Remote-SSH”，而是远程机器的 SSH 状态、基础依赖、用户权限这三者是否干净对齐。一旦其中一环有偏差，VSCode 就会静默失败或卡在某个阶段——这时候看输出面板的 “Remote Server” 日志，比反复重装插件有用得多。
