Remote-SSH连接失败的三大硬性前提是：SSH终端必须能无密码直连；私钥权限须为600且IdentityFile用绝对路径；远程shell需正确加载环境变量（如在.bash_profile中source .bashrc），否则集成终端命令不可用。
Linux服务器本身不装VSCode图形版，Remote-SSH也不是“安装VSCode到服务器”，而是自动部署轻量vscode-server进程——它不依赖X11/Wayland，纯命令行环境就能跑。
Remote-SSH连接失败的三个硬性前提
VSCode Remote-SSH不是独立协议，它完全复用你本地终端的SSH能力。连不上，90%问题出在底层SSH配置上：
- 终端执行
ssh user@host必须能直接登录（不输密码），否则VSCode必然卡在“Connecting…” -
~/.ssh/config中的IdentityFile必须写绝对路径，比如/home/user/.ssh/id_rsa，不能用~/id_rsa - 私钥权限必须是
600：运行chmod 600 ~/.ssh/id_rsa，否则VSCode静默拒绝加载密钥
连接后终端打不开或git/node报command not found
Remote-SSH启动的是非登录、非交互式shell，~/.bashrc默认不加载——所以你在终端里能用的命令，在VSCode集成终端里可能根本找不到。
- 检查远程用户默认shell：
grep ^$USER /etc/passwd，确保不是/bin/false或/usr/sbin/nologin - 在
~/.bash_profile或~/.profile末尾加一行：[[ -f ~/.bashrc ]] && source ~/.bashrc - 如果用zsh，确保
~/.zprofile里有source ~/.zshrc - 别在
~/.bashrc开头写echo、clear或阻塞型命令，否则VSCode读取环境变量会失败
Installing VS Code Server 卡住超过2分钟
这不是VSCode的问题，而是远程服务器缺基础工具或网络不通。VSCode Server本质是个tar包，需要tar和gzip解压，且默认从微软CDN拉取。
- 手动登录服务器，运行：
bash -ilc 'echo OK'—— 如果没输出或报错，说明shell初始化脚本有语法错误 - 确认已安装：
which tar gzip，CentOS最小化安装常缺gzip - 离线场景下，需提前下载对应commit-id的
vscode-server-linux-x64.tar.gz，解压后放入~/.vscode-server/bin/{commit_id}/ - 新版目录结构已变，
bin下不再直接放可执行文件，而是按commit-id分目录，别放错位置
真正容易被忽略的是shell初始化顺序和离线时commit-id的严格匹配——VSCode客户端版本、本地下载的server包、远程目录结构三者必须对齐，差一个字符都会导致server启动失败，且错误日志藏得深，只在~/.vscode-server/.cpuprofile或~/.vscode-server/remote-ssh/error.log里留痕迹。
