VSCode远程开发卡顿主因是SSH连接不稳定、vscode-server安装失败及远程环境配置错误；需确保ssh命令行能直连、~/.ssh/config配置完整、远程具备curl/unzip等基础工具且磁盘空间充足，并在SSH扩展面板中单独安装远程插件。
VSCode 远程开发不是“装个插件就能连”，核心卡点永远在 SSH 通不通、vscode-server 装不装得上、远程环境认不认你配的 Shell。三者缺一不可，跳过任意一步都会卡在“Connecting…”或“Installing VS Code Server”不动。
ssh user@host 命令行先跑通，否则 Remote-SSH 一定失败
Remote-SSH 完全复用你系统的 SSH 配置和密钥，它不会自己另起一套认证逻辑。
- 在终端直接执行
ssh user@host（比如ssh deploy@192.168.1.100），必须能登录成功——首次连接会提示 yes/no，输 yes；若报Permission denied (publickey)，说明密钥没配好，别急着开 VS Code - 检查私钥权限：
chmod 600 ~/.ssh/id_rsa_myserver，OpenSSH 默认拒绝加载权限过宽的私钥 - 确认远程
/etc/ssh/sshd_config中PubkeyAuthentication yes和PasswordAuthentication yes（如需密码登录）已启用，改完记得sudo systemctl restart sshd - Windows 用户注意：PowerShell 和 WSL 的 SSH 配置是分开的，建议统一用 WSL 终端测试，避免路径错乱
~/.ssh/config 必须显式写全关键字段，不能靠默认
VS Code 的 Remote-SSH 会读取 ~/.ssh/config，但很多配置漏掉必要项，导致连接时静默失败或反复弹密码框。
- Host 别名随便取（如
myprod），但HostName、User、IdentityFile三项必须写全，不能省略 - 如果服务器 SSH 端口不是 22（比如阿里云常改到 2222），必须加
Port 2222，否则连不上 - 缩进只能用空格，不能用 Tab——某些 OpenSSH 版本会直接忽略整段配置
- 示例最小可用配置：
Host myprod HostName 192.168.10.5 User deploy Port 2222 IdentityFile ~/.ssh/id_rsa_myserver
保存后，在 VS Code 中按 Ctrl+Shift+P → 输入 Remote-SSH: Connect to Host...，就能看到 myprod 可选。
vscode-server 卡在 “Installing…”？先查远程基础能力
首次连接时，VS Code 会在远程自动下载并解压 vscode-server 到 ~/.vscode-server/bin/ 下。这步失败，90% 是因为远程缺基础工具或权限不对。
- 登录服务器后，手动运行：
which curl wget unzip tar，缺哪个就装哪个（如 Ubuntu：sudo apt install curl unzip） - 检查磁盘空间：
df -h ~，~/.vscode-server目录必须可写且有足够空间（至少 300MB） - 如果远程是容器、Alpine 或 NFS 挂载目录，可能因缺少 glibc 或
noexec挂载选项失败；可临时改用本地路径测试：export VSCODE_AGENT_FOLDER="/tmp/vscode-server" - 国内网络常卡在下载阶段：去 https://www.php.cn/link/eb7e87877c44af2443759ea1ef235358 找对应 commit 的
vscode-server-linux-x64.tar.gz，上传到服务器~/.vscode-server/bin/下解压即可
远程插件、终端、Python 解释器都得“重装一遍”
你在本地装的插件（如 Python、Prettier、ESLint）默认只跑在本地，对远程文件完全无效。Remote-SSH 的所有能力都依赖远程进程。
- 连接成功后，打开左侧扩展面板，顶部会多出
SSH: myprod分类，所有需生效的插件必须在这里单独安装 - 终端启动时默认不加载
.bashrc或.zshrc，如果你的$PATH或 Python 路径靠它们设置，需在~/.ssh/config对应 Host 块里加：SetEnv VSCODE_SSH=1，并在远程~/.bashrc开头加判断：if [ -n "$VSCODE_SSH" ]; then source ~/.bashrc; fi - 调试 Python 时，
python.defaultInterpreterPath必须设为远程绝对路径（如/opt/python3.9/bin/python），不能写本地路径或相对路径
最易被忽略的是：远程窗口里打开的终端、执行的 git 命令、触发的断点调试，全部发生在服务器上——你看到的“本地编辑”，背后没有一次文件同步，全是直写远端磁盘。路径错、权限错、环境变量没继承，问题就会立刻暴露。
