Remote-SSH 连接成功但无法运行 Python 的根本原因有三：缺 User 或 IdentityFile 导致连接失败；远程未装 Python 或 PATH 未配置导致 which python3 为空；Python 扩展未在远程窗口安装导致功能失效。
~/.ssh/config 缺字段，Remote-SSH 就卡在 “Setting up SSH Host”
VS Code 的 Remote-SSH 不会猜你的用户名、密钥路径或端口。只写 Host 和 HostName，基本连不上。
-
User必须显式声明，不能省略（比如User zhangsan） -
IdentityFile要用绝对路径（如/home/zhangsan/.ssh/id_ed25519），且权限必须是600：chmod 600 /path/to/private_key - 如果服务器 SSH 端口不是 22，
Port字段不能少；光在HostName后面加:2222是无效的 -
Host别名只能含字母、数字、短横线（如mygpu），不能带下划线或空格
远程终端里 which python3 返回空，说明环境根本没配好
Remote-SSH 只转发文件系统和界面，不帮你装 Python，也不自动加载 shell 配置。
- 先确认远程已装 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 插件对远程窗口完全无效。右下角没有 Remote 标签，就等于没启用。
- 连接成功后，在新窗口打开一个
.py文件，再点左侧扩展图标搜Python - 确认右下角状态栏有
Remote标签，且 Python 扩展状态为“已启用”；若显示“未启用”，点击Install on SSH: mygpu手动安装 - F5 调试前，务必按
Ctrl+Shift+P→ 输入Python: Select Interpreter，粘贴which python返回的完整路径 - 必要时手动检查
.vscode/launch.json中python字段是否指向该绝对路径
能连上不代表能跑 Python，三处不填满就白忙活
真正卡住人的永远不是“连不上”，而是连上了却跑不动脚本——问题几乎全集中在配置细节里。
立即学习“Python免费学习笔记（深入）”；
缺 User 或 IdentityFile 会导致连接失败；远程没装 Python 或没设好 PATH，which python3 就为空；Python 扩展没在远程窗口装，编辑器就只剩个记事本功能。这三处任何一个漏掉，调试器就进不了断点，import numpy 就报错，连 print("hello") 都执行不了。
