远程开发卡顿主因是vscode-server启动失败或Shell初始化阻塞，而非网络慢；应优先检查SSH直连、手动部署server、绕过profile加载，三者为真正卡点。
远程开发卡顿，90% 不是网络慢，而是 vscode-server 启动失败或 Shell 初始化阻塞。 直接改配置、跳过自动安装、绕过 shell profile 加载，比调优网络更有效。
ssh 命令行连不通，Remote-SSH 一定失败
VS Code 的 Remote-SSH 完全复用系统 ssh 命令，不另起认证逻辑。终端里 ssh deploy@192.168.1.100 -p 2222 都进不去，VS Code 必然卡在 “Connecting…”。
- 首次连接必须输
yes确认 host key，否则 Remote-SSH 会静默挂起 -
Permission denied (publickey)：检查私钥权限是否为600（chmod 600 ~/.ssh/id_rsa_myserver），公钥是否完整写入远程~/.ssh/authorized_keys（末尾不能有多余空格或换行） - Windows 用户注意：PowerShell 和 WSL 的
~/.ssh/config是两套路径，建议统一用 WSL 终端测试 - 云服务器务必同步检查安全组——端口开放 ≠ SSH 服务在监听，用
sudo ss -tuln | grep ':2222'确认
~/.ssh/config 配置漏项，会导致反复弹密码框或连接静默失败
Remote-SSH 主机列表只读 ~/.ssh/config，UI 里手动填 IP 是临时的、不可复用、也不支持 IdentityFile。
- 必须显式写全：
HostName、User、Port（非 22 时）、IdentityFile；缺任意一项都可能 fallback 到密码登录 - 别名只能含小写字母、数字、短横线（
my-prod✅，my_prod❌） - 缩进必须用空格，不能用 Tab——某些 OpenSSH 版本会直接忽略整段
- 加
StrictHostKeyChecking no和UserKnownHostsFile /dev/null可避免首次连接卡住（仅限可信内网）
卡在 “Installing VS Code Server”？手动部署更稳
自动安装依赖远程有 curl、tar、unzip、bash，且 ~/.vscode-server 目录可写。缺一即停，状态栏只显示 “Installing…” 不报错。
- 先登录服务器，运行
which curl tar unzip bash，缺哪个装哪个（Ubuntu/Debian：sudo apt install -y curl tar unzip） - 检查磁盘空间：
df -h ~，~/.vscode-server至少留 3GB - 手动下载对应 commit 的 server 包：
https://update.code.visualstudio.com/commit:abcd1234/server-linux-x64/stable（commit ID 查本地 VS Code 关于页或code --version输出） - 解压到指定路径：
mkdir -p ~/.vscode-server/bin/abcd1234 && tar -xzf vscode-server-linux-x64.tar.gz -C ~/.vscode-server/bin/abcd1234 --strip-components 1
连接成功但终端卡住、命令无响应？Shell 初始化被阻塞
Remote-SSH 默认加载你的 ~/.bashrc 或 ~/.zshrc，里面若有交互式命令（如 read）、长耗时脚本（如 SDK 初始化）、或未判断 [ -t 0 ] 就执行的语句，会导致 vscode-server 启动卡死。
- 临时验证：在服务器上运行
bash --norc --noprofile -i -c 'echo ok'，若卡住说明 shell 配置有问题 - 快速绕过：在
~/.ssh/config对应 Host 段加RemoteCommand bash -l -c 'exec "$SHELL"'（慎用，可能影响环境变量） - 长期方案：把所有非交互、非必要初始化逻辑包在
if [ -t 0 ]; then ... fi中 - 检查
~/.vscode-server是否被挂载为只读（如某些容器或 NFS 挂载场景），ls -ld ~/.vscode-server看权限
真正卡点永远在三件事：ssh 能不能直连、vscode-server 装不装得上、shell profile 会不会阻塞。网络带宽和延迟反而是最后才需要看的。尤其当服务器是轻量云实例或容器环境时，基础工具缺失和 shell 初始化问题出现频率远高于网络问题。
