必须用专业版，社区版不支持；SSH配置在Settings→Build,Execution,Deployment→Remote，需填Host、Port、Username、Authentication type四项，Test Connection失败多因端口错、密钥权限不足或路径不合法。
PyCharm 配置 SSH 连接必须用专业版，社区版不支持；连接失败八成是端口、密钥权限或路径填错，不是软件问题。
SSH 配置在哪设置
打开 File > Settings（Windows/Linux）或 PyCharm > Preferences（macOS），路径是：Build, Execution, Deployment > Remote 或直接搜 SSH Configurations。别去 Python Interpreter 里瞎点“Add”，那是配解释器的入口，不是配 SSH 连接本身的。
点击加号新建，填四项核心信息：
-
Host：服务器 IP 或域名（比如region-1.autodl.com），别漏写www.或子域名 -
Port：默认22，但 AutoDL、Vast.ai 等平台常用非标端口（如38076），务必核对 SSH 登录命令里的-p参数 -
Username：通常是root或你自己的账号，注意大小写和拼写 -
Authentication type：选Password就填密码；选Key pair必须指定私钥路径（如~/.ssh/id_ed25519），且确保私钥文件权限是600（chmod 600 ~/.ssh/id_ed25519）
为什么 Test Connection 总失败
常见错误不是密码错，而是环境细节被忽略：
PyCharm 2026.2
下载
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 勾选了
Resolve configuration file ~/.ssh/config，但本地~/.ssh/config里对应 Host 的配置有冲突（比如多了一行StrictHostKeyChecking no或错误的IdentityFile），建议先取消勾选再测 - 服务器防火墙或云平台安全组没放行该端口，
telnet your-host 38076能通才说明网络层没问题 - 用密钥登录时，公钥没正确追加到服务器的
~/.ssh/authorized_keys（ssh-copy-id比手动复制更可靠） - PyCharm 启动时没读取系统
ssh-agent，选OpenSSH configuration and authentication agent类型可绕过私钥路径填写，但需提前运行eval $(ssh-agent)并ssh-add
配完 SSH 怎么用到项目里
SSH 配置本身只是“连接凭证”，不等于能跑代码。真正起作用的是后续两步：
- 配远程解释器：进
Project > Python Interpreter > Add > SSH Interpreter，选你刚建好的 SSH 配置，再填远程 Python 路径（如/root/miniconda3/envs/myenv/bin/python）。注意：这里填的是python可执行文件，不是 conda 环境目录 - 设同步路径：解释器配置页会弹出映射设置，
Local path填你本地项目根目录（如D:\myproj），Remote path填服务器上存放该项目的绝对路径（如/root/autodl-tmp/myproj）。这个路径必须真实存在且有写权限，否则保存时会报错
这两步缺一不可——只配 SSH 连接，PyCharm 不知道该用哪个 Python、代码往哪传；只配解释器不设同步路径，改完本地代码根本不会上服务器。
容易被忽略的权限和路径细节
很多问题卡在路径和权限上，而不是连接逻辑：
- 远程 Python 解释器路径不能用
~，必须写绝对路径（/home/user/venv/bin/python✅，~/venv/bin/python❌） - 同步路径的远程端目录，PyCharm 不会自动创建，得先 SSH 登上去
mkdir -p /root/autodl-tmp/myproj - 如果服务器禁用了密码登录（只允许密钥），但你在 PyCharm 里选了
Password认证类型，测试必然失败——类型必须和服务器实际接受的方式一致 - 同一套 SSH 配置可被多个项目复用，但“仅对该项目可见”选项一旦勾选，换个项目就得重配；团队协作建议不勾，让配置存 IDE 全局目录
