remote-ssh连接成功仅是起点，后续需装microsoft官方插件、配全ssh config（含host/hostname/user/identityfile）、确保远程python环境就绪、指定解释器路径、处理同步延迟与挂载权限等问题。
能连上 SSH 不代表代码能跑——Remote-SSH 连接成功只是起点，真正卡住人的都在后续执行环节。
Remote - SSH 插件必须装对，别被名字带偏
VS Code 市场搜 remote ssh 会出来一堆插件，但只有作者是 Microsoft、全名是 Remote - SSH 的那个才支持终端集成、调试器和远程扩展自动安装。其他像 SSH FS 或 Remote SSH Editor 只能读写文件，点 F5 调试直接报错，等同于换了个高级 FTP 工具。
装完必须重启 VS Code，否则左下角不会出现 SSH TARGETS 图标。插件不存密码也不管理密钥，它完全依赖本地 ~/.ssh/config 或系统 SSH 配置。
~/.ssh/config 必须写全字段，漏一个就卡死
很多人只写 Host 和 HostName，结果报 Permission denied (publickey) 或无限转圈。VS Code 不会猜 User，也不会默认用 ~/.ssh/id_rsa——你得明说。
-
HostName、IdentityFile必须是绝对路径（比如/home/user/.ssh/id_rsa_myserver） -
IdentityFile权限必须为600：chmod 600 ~/.ssh/id_rsa_myserver - 如果服务器改过 SSH 端口（比如
2222），一定要加Port 2222，光写 IP 没用 - Windows 用户确认已启用 OpenSSH 客户端（设置 → 应用 → 可选功能里勾选）
远程终端里 python 找不到，不是 VS Code 的问题
Remote-SSH 只负责把编辑器界面连过去，python、node、gcc 全靠服务器自己装。连上了却运行不了脚本，90% 是环境没配好。
- 先在 VS Code 内置终端里执行：
which python3，返回空就说明根本没装 - Ubuntu/Debian：
sudo apt install python3 python3-pip；CentOS：sudo yum install python3 python3-pip -
F5调试失败？打开命令面板，搜Python: Select Interpreter，手动指定远程路径，如/usr/bin/python3 - 用了
conda或virtualenv？必须先在远程终端里source activate myenv，再从该终端执行code .启动 VS Code，否则环境不继承
代码改了但输出还是旧的，别急着重连
VS Code Remote 默认只同步当前打开的文件，不是实时 rsync 整个目录。改完保存后，右下角若显示 Syncing changes…，得等它消失再运行。
- 强制上传单个文件：
右键文件 → Upload to … - 运行前先查残留进程：
ps aux | grep python，尤其Flask、Streamlit这类常驻服务 - 国内网络首次连接常卡在下载
vscode-server，可手动下载对应 commit hash 的 tar 包，传到远程~/.vscode-server/bin/下解压
最易被忽略的是：远程插件必须单独装，本地装的 Prettier、ESLint 默认不生效；右下角弹窗提示“Install in SSH: xxx”才是正确路径。
