remote-ssh连接成功仅是开端，后续需装microsoft官方插件、配置完整ssh config（含host/hostname/user/identityfile）、确保远程python环境就绪、指定解释器路径、处理同步延迟与挂载权限等问题。
能连上不代表能跑代码——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 配置 - Windows 用户确认已启用 OpenSSH 客户端（设置 → 应用 → 可选功能里勾选）
~/.ssh/config 配置漏字段，连接就卡在 “Setting up SSH Host”
很多人只写 Host 和 HostName，结果报 Permission denied (publickey) 或无限转圈。VS Code 不会猜 User，也不会默认用 ~/.ssh/id_rsa——你得明说。
- 最小可用配置必须包含：
Host、HostName、User、IdentityFile -
IdentityFile必须是绝对路径，且权限为600：chmod 600 ~/.ssh/id_rsa_myserver - 如果服务器改过 SSH 端口（比如
2222），一定要加Port 2222，光写 IP 没用 - 国内网络首次连接常卡在下载
vscode-server，可手动下载对应 commit hash 的 tar 包，传到远程~/.vscode-server/bin/下解压
远程终端里 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 这类常驻服务 - 读文件出错？加一句
import os; os.chdir(os.path.dirname(__file__))，避免工作目录不是脚本所在路径 - 调用
input()卡住？调试时launch.json里加上"console": "integratedTerminal"，别用internalConsole
最易忽略的一点：远端 ~/.vscode-server 目录可能被挂载为 noexec，或家目录是 NFS 共享，导致 vscode-server 无法执行——现象是连接成功但所有功能灰掉，连终端都打不开。这时得看服务器 mount 输出，或联系管理员确认权限策略。
