能连上不等于能用，主因是未认清远程端才是真实运行环境：SSH连通后卡在“Installing VS Code Server”、git/python异常、扩展不生效，均源于远程环境未正确初始化、环境变量未加载、权限或工具缺失、路径配置错误及未真正切换至远程工作区。
能连上不等于能用——Remote-SSH 连通后卡在“Installing VS Code Server”、终端里 git 不认、python 解释器路径错、扩展装了但不生效，主因是没认清「远程端才是真实运行环境」这个前提。
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 - 扩展装了但不生效 → 右下角点击
Remote [SSH]，选择Disable All Installed Extensions，只启用标有 Remote 或 SSH 兼容标识的插件 - 编辑器设置中避免写死本地路径，例如
"python.defaultInterpreterPath"应设为远程路径，而非"C:\Users\xxx\..."
连接后 code --list-extensions 返回的是本地列表？
说明 VS Code 没真正切到远程环境——它只是开了个本地窗口，没加载远程服务端。正确做法是：连接成功后，先按 Ctrl+Shift+P 输入 Remote-SSH: Open Folder，选一个远程路径打开工作区。之后再运行 code --list-extensions，返回的才是远程服务器上的扩展列表。这一步漏掉，后续所有环境配置都会错位。
