能连上不代表能跑Python——Remote-SSH连接成功只是起点，真正卡住人的在~/.ssh/config配置（缺User/IdentityFile等字段会失败）、远程解释器路径未显式指定、Python扩展未在远程窗口安装启用这三处。
能连上不代表能跑 Python —— Remote-SSH 连接成功只是起点，真正卡住人的都在 ~/.ssh/config 配置、远程解释器路径、扩展安装位置这三处。
为什么 ~/.ssh/config 少一个字段就连接失败
VS Code 的 Remote-SSH 不会自动推断 User 或默认用 ~/.ssh/id_rsa。只写 Host 和 HostName，大概率卡在 “Setting up SSH Host” 或报 Permission denied (publickey)。
-
Host是你起的别名（如mygpu），只能含字母、数字、短横线 -
HostName必须是 IP 或域名，不能带ssh://或端口 -
User必须显式声明，不能省略 -
IdentityFile要用绝对路径（如/home/user/.ssh/id_ed25519），且权限必须是600：chmod 600 /path/to/private_key - 如果服务器 SSH 端口不是 22，
Port字段不能少，光改HostName后加:2222没用
远程终端里 python3 找不到？不是 VS Code 的锅
Remote-SSH 只转发编辑器界面和文件系统，不帮你装 Python、不加载 shell 环境变量。打开内置终端（Ctrl + `）后执行 which python3 返回空，说明远程环境根本没配好。
- 先确认远程服务器已装 Python：
sudo apt install python3 python3-pip（Ubuntu/Debian）或sudo yum install python3 python3-pip（CentOS/RHEL） - 如果用了 conda 或 virtualenv，确保激活后运行
which python得到的是完整路径（如/home/user/miniconda3/envs/ml/bin/python） - VS Code 默认不读
~/.bashrc，需在~/.bash_profile末尾加：if [ -f ~/.bashrc ]; then source ~/.bashrc; fi - 改完配置后，必须关闭整个 VS Code 窗口再重连，仅“重载窗口”无效
Python 扩展显示“已禁用”，调试断点灰色
本地装的 Python 插件对远程窗口完全无效。远程窗口里看到的“未启用”状态，意味着补全、linting、调试全部瘫痪。
立即学习“Python免费学习笔记（深入）”；
- 连接成功后，在新窗口中打开一个
.py文件，再点左侧扩展图标搜Python - 确认右下角有
Remote标签，且状态为“已启用”；若没有，点击Install on SSH: mygpu手动安装 - F5 调试前，务必按
Ctrl+Shift+P→ 输入Python: Select Interpreter，粘贴which python的输出结果（必须是绝对路径） - 检查
.vscode/launch.json中python字段是否与上述路径一致，不能写成python3或相对路径
国内首次连接卡在下载 vscode-server
VS Code 会尝试从 GitHub 下载服务端组件，国内直连常超时或中断，表现为无限转圈、连接后无响应。
- 打开命令面板（
Ctrl+Shift+P），运行Remote-SSH: Kill VS Code Server on Host...清理残留 - 在远程终端中手动创建目录：
mkdir -p ~/.vscode-server/bin/ - 去 https://www.php.cn/link/506bcafd6d99043b2d6d1a7e5f6743e3 + 当前 VS Code 版本 commit hash（可在 VS Code 关于页查到）下载 tar 包
- 用
scp传上去，解压：tar -xzf vscode-server-linux-x64.tar.gz -C ~/.vscode-server/bin/<commit-hash> - 重连即可跳过自动下载环节
最容易被忽略的是：VS Code 不会继承你的 shell 登录行为，~/.bash_profile 和 ~/.bashrc 的加载顺序、Python 虚拟环境是否激活、插件是否真装到了远程——这三件事不手动验证，光靠“连上了”就开写，十有八九会在 F5 时栽跟头。
