怎么将VSCode连接到远程服务器_VSCode Remote SSH远程开发配置教程-VSCode-PHP中文网

vscode连不上远程服务器，首要原因是本地ssh命令不通，必须先在终端执行ssh -i私钥 user@host成功登录；再检查~/.ssh/config语法与权限、远程curl/tar/glibc依赖及~/.vscode-server部署状态。

怎么将vscode连接到远程服务器_vscode remote ssh远程开发配置教程

VSCode 连不上远程服务器，95% 的情况不是插件没装对，而是本地 ssh 命令根本连不通——别跳过终端直连这一步，它决定了后续所有环节是否成立。

为什么 `ssh user@host` 在终端失败，VSCode 一定连不上

Remote-SSH 插件底层调用的是你系统 PATH 下的 ssh 命令，不是它自己带的。任何“点一下就连接”的幻想，都建立在终端能成功登录的前提下。

运行 ssh -i ~/.ssh/my_key user@192.168.1.100 -p 2222，必须能免密进入 shell；如果提示 Permission denied (publickey)，先别开 VSCode
检查私钥权限：chmod 600 ~/.ssh/my_key（644 或 755 都会拒绝加载）
确认公钥已完整追加到远程 ~/.ssh/authorized_keys：无空行、末尾无空格、不能有 DOS 换行符（file ~/.ssh/authorized_keys 看是否显示 CRLF）
远程 /etc/ssh/sshd_config 必须含 PubkeyAuthentication yes 且 AllowUsers 包含你的用户名（云服务器常默认只允 root 或特定用户）

`~/.ssh/config` 配错，VSCode 就看不到主机名

VSCode Remote-SSH 主界面列出的所有主机，完全来自你本地 ~/.ssh/config 文件。手动在 UI 里输地址只会生成临时配置，不支持 IdentityFile、无法 alias、多跳场景直接崩。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

在 ~/.ssh/config 中写标准块（缩进必须是空格，不能用 Tab）：

Host myserver
  HostName 192.168.1.100
  User ubuntu
  Port 2222
  IdentityFile ~/.ssh/my_key
  StrictHostKeyChecking no
  UserKnownHostsFile /dev/null

保存后，按 Ctrl+Shift+P → 输入 Remote-SSH: Reload Window，再执行 Remote-SSH: Connect to Host 才能看到 myserver
Windows 用户若用 WSL，注意 ~/.ssh/config 是 WSL 下的路径，PowerShell 里的配置 VSCode 不读

卡在 “Installing VS Code Server…”？远程环境缺东西或网络被墙

VSCode 连上 SSH 后，会在远程自动拉取并解压 vscode-server-linux-x64.tar.gz 到 ~/.vscode-server/bin/<commit>/</commit>。卡住 ≠ 连接失败，而是远程初始化失败。

常见现象：Failed to fetch remote environment、Cannot create directory /home/user/.vscode-server、日志里报 curl: command not found
远程必须有：curl 或 wget + tar + bash（Alpine 容器等极简系统常缺 glibc 或 tar）
国内服务器若无法访问 update.code.visualstudio.com，手动下载对应 commit 的 tar 包，传到 ~/.vscode-server/bin/<commit>/</commit> 并解压（路径必须严格匹配）
远程 ~/.bashrc 或 ~/.zshrc 里有 echo、clear 或阻塞输出的命令，会导致 VSCode 无法解析 shell 环境 —— 加个判断：if [ -z "$VSCODE_SSH_HOST" ]; then ... fi

远程插件不生效、Python 解释器找不到？它们根本没装到远端

你在本地安装的 Prettier、ESLint、Python 插件，默认只跑在本地进程里。远程开发时，语言服务、调试器、格式化工具必须运行在远程机器上，否则路径错、依赖漏、解释器识别失败。

连接成功后，在左侧扩展面板顶部，切换到 SSH: myserver 分类（不是“已安装”）
搜插件，找到后点击右下角的 Install on SSH: myserver（不是“Install”按钮）
Python 用户特别注意：远程 python 路径要手动指定（Ctrl+Shift+P → Python: Select Interpreter），选 /usr/bin/python3 或虚拟环境里的 bin/python
符号链接跨文件系统时可能显示为空白 —— 这不是 VSCode bug，是远程 ls -l 本身无法解析；用 readlink -f /path/to/symlink 确认真实路径再打开