能连上但首次常卡在密码输入、密钥确认或vs code server安装环节，根本原因是远程环境缺依赖（如curl、tar、glibc）或权限受限；必须安装microsoft官方remote - ssh插件（注意名称含空格和短横），并确保配置命令格式正确：ssh username@ip -p 端口，保存至~/.ssh/config。
能连上，但大概率第一次会卡在密码输入、密钥确认或 VS Code Server 安装环节——不是配置错了，而是远程环境缺依赖或权限受限。
Remote-SSH 插件必须装，且不能只装一半
插件名是 Remote - SSH（注意中间有空格和短横），必须由 Microsoft 官方发布。别装错成第三方“SSH”或“SSH Config”类插件。
- 安装后左下角会出现绿色状态栏，显示
Open SSH Configuration File或Connect to Host...入口 - 如果没出现，重启 VS Code；仍不出现，检查是否被企业策略禁用了插件自动启用
- 建议顺手装上
Remote - SSH: Editing Configuration Files，它能帮你校验~/.ssh/config语法
连接命令里端口、用户名、IP 顺序不能颠倒
VS Code 要求你输入的是完整 ssh 命令，不是主机名或 IP 单独一行。常见错误是漏掉 @ 或把端口写成 -P（大写 P）——正确是 -p（小写 p）。
- 标准格式：
ssh username@192.168.1.100（默认 22 端口） - 非标端口：
ssh username@192.168.1.100 -p 2222 - 带密钥路径：
ssh -i ~/.ssh/id_rsa username@192.168.1.100（这个命令会被存进~/.ssh/config，后续可省略-i） - 输完回车后，VS Code 会弹出保存位置选项，选第一个（
~/.ssh/config），否则下次找不到连接项
首次连接失败，八成卡在 VS Code Server 安装阶段
VS Code 连上后会在远程服务器自动部署一个轻量服务端（vscode-server），它依赖 curl、tar、unzip 和 glibc。内网或精简版 Linux（如 Alpine、某些国产信创系统）常缺这些。
- 手动验证：
ssh username@host进去后运行curl --version和tar --version，任一缺失就装不上 - 若提示
Failed to fetch remote extension host或卡在Installing VS Code Server，先在远程终端执行：mkdir -p ~/.vscode-server/bin && cd ~/.vscode-server/bin && curl -L https://update.code.visualstudio.com/commit:xxx/server-linux-x64/stable | tar -xzf -（xxx 替换为 VS Code 右下角显示的 commit ID） - 没
curl？用wget替代，或提前把vscode-server包 scp 上去再解压
连上了却打不开文件夹，多半是权限或路径问题
点击 Open Folder 后提示 Permission denied 或 No such file or directory，不是网络问题，是远程用户对目标路径没读取权，或路径拼写含中文/空格没转义。
- 先用
ssh登进去，手动ls -l /home/username/project确认路径存在且可读 - 路径含空格？用引号包住：
/home/username/my project→"/home/username/my project" - 用 root 登录但项目在普通用户家目录？VS Code 默认以登录用户身份操作，别指望它自动切用户
- 云服务器（如阿里云）默认关闭 home 目录的 world-readable 权限，
chmod o+x /home/username才能让 VS Code 的文件服务访问到子目录
真正麻烦的不是连不上，而是连上了却看不见文件、跑不了终端、插件不加载——这些问题都藏在远程用户的 shell 环境、PATH 和文件权限里，而不是 SSH 配置本身。
