能连上不等于能用，Remote-SSH连通后卡在“安装VS Code Server”、git不认、python路径错、扩展不生效，主因是未认清远程端才是真实运行环境。
能连上不等于能用——Remote-SSH 连通后卡在“正在安装 VS Code Server”、终端里 git 不认、python 解释器路径错、扩展装了但不生效，90% 都是因为没理清「远程端才是真运行环境」这个前提。
ssh 命令能连通，VS Code 却报 Permission denied (publickey)
VS Code 的 Remote-SSH 扩展底层调用的是你系统里的 ssh 命令，但它不会自动加载 ssh-agent 或读取所有配置项。常见断点：
-
~/.ssh/config中的Host别名含下划线（如my_server）→ OpenSSH 会静默忽略，改用my-server - 私钥文件权限不是
600→ 运行chmod 600 ~/.ssh/id_rsa，否则 OpenSSH 直接拒载 - 私钥有密码但没提前
ssh-add ~/.ssh/id_rsa→ VS Code 会反复弹窗输密，甚至卡死连接流程 - 远程服务器禁用了密码登录（
PasswordAuthentication no），而你又没配好公钥 → 检查远程/etc/ssh/sshd_config，确认PubkeyAuthentication yes
首次连接卡在 “Installing VS Code Server”
这不是 VS Code 的问题，是远程机器无法完成二进制下载或解压。关键检查点：
- 远程机器能否访问
update.code.visualstudio.com？国内网络常被卡住 → 查看 VS Code 输出面板 → 选 “Remote Server”，若出现Failed to fetch download URL，就得手动部署 - 远程
~/.vscode-server目录是否可写？如果之前用sudo启动过，该目录可能属root，普通用户无法覆盖 → 运行rm -rf ~/.vscode-server ~/.vscode-server-insiders清空重试 - 远程缺基础工具：检查
which tar curl unzip，缺失就补（Ubuntu：sudo apt install -y tar curl unzip；Alpine：apk add tar curl unzip） - 远程是 ARM 架构（如树莓派、M1 Mac）但插件下了 x64 包 → 看输出日志是否报
cannot execute binary file，需确认 VS Code 版本是否支持，或换用vscode-server-alpine专用包
连上了，但终端/调试/Git 全部异常
VS Code 远程启动时默认用 /bin/sh 启动服务，不会自动 source ~/.bashrc 或 ~/.zshrc，所以你的环境变量、别名、PATH 全都不生效。
- Git 报
fatal: not a git repository或凭据失效 → 在远程终端手动运行git config --global credential.helper store，再执行一次git pull触发凭据保存 - Python 扩展找不到解释器 → 不要依赖本地设置，必须在远程工作区里打开命令面板，运行
Python: Select Interpreter，路径要填远程绝对路径，如/usr/bin/python3 - 终端一打开就是
/bin/sh，没有历史记录和补全 → 修改远程~/.vscode-server/data/Machine/settings.json（或在远程窗口按Ctrl+, → Settings → Terminal > Integrated > Shell: Linux），设为/bin/bash - 扩展装了但语言服务不启动 → 确认扩展是装在「Remote」侧（右下角状态栏显示 [SSH: xxx] 时再装），不是本地；某些扩展（如 Docker）还要求远程已安装对应 CLI 工具
remote.ssh.path 配置错导致根本连不出
VS Code 默认调用系统 ssh，但如果你用 Homebrew 装了新版 OpenSSH（macOS）、或在 Windows 上混用 WSL 和 Git Bash，它可能找不到正确二进制。
- macOS Homebrew 用户：在 VS Code 设置里搜
remote.ssh.path，填/opt/homebrew/bin/ssh（Apple Silicon）或/usr/local/bin/ssh（Intel） - Windows + WSL 场景：想连 WSL 本身？不用 Remote-SSH，用 Remote-WSL；想从 WSL 内连另一台服务器？确保
remote.ssh.path指向 WSL 里的/usr/bin/ssh，而不是 Windows 的cmd.exe - 路径不对的典型表现：VS Code 根本不弹出主机列表，或点击连接后秒退，输出面板里看不到任何 SSH 日志 → 此时去设置里检查
remote.ssh.path是否指向一个真实可执行的ssh
最易被忽略的一点：所有路径、权限、环境变量、shell 初始化逻辑，都以远程用户身份为准。你不能靠本地改设置绕过远程的 $HOME 权限问题，也不能指望远程的 ~/.profile 自动被 VS Code 加载——它只认 /bin/sh 的最小环境。动手前，先在终端里 ssh user@host 进去跑一遍你要用的命令，确认它们在纯 sh 下能跑通。
