先确认本地 ssh 命令能否连通：在终端执行 ssh -i 私钥 user@host -p 端口，若失败则问题在 SSH 层（密钥权限、sshd 服务、防火墙或配置错误）；PyCharm 远程解释器依赖系统 ssh，不解决底层连接就无法继续。
PyCharm 连不上远程 SSH 解释器，先查 ssh 命令是否能通
PyCharm 的远程解释器底层依赖本地 ssh 客户端（Windows 需确认已安装 OpenSSH 或 Git Bash，且在 PATH 中）。如果点击测试连接时卡住或报 Connection refused、Permission denied (publickey)，别急着调 PyCharm 设置——先在终端手动跑一遍：
ssh -i /path/to/private_key user@host -p 22
不通？说明问题出在 SSH 层：密钥权限不对（chmod 600）、~/.ssh/config 配置有误、远程 sshd 未监听对应端口，或防火墙拦截。PyCharm 不会帮你修 SSH 配置，它只是调用你系统的 ssh。
配置解释器时选错 “SFTP 路径” 会导致同步失败或找不到包
在 Project Interpreter → Add → SSH Interpreter → Configuration and deployment 页面，PyCharm 要求填两个关键路径：
-
Deployment path on server：这是项目上传到服务器的**绝对路径**，比如/home/user/myproject。必须确保该目录存在且用户有写权限；否则后续pip install会失败，报PermissionError: [Errno 13] Permission denied -
Python interpreter path：填服务器上 Python 可执行文件的绝对路径，例如/opt/conda/bin/python或/usr/bin/python3.9。别填python或python3—— 没有 PATH 上下文，PyCharm 找不到。
填错前者，PyCharm 传文件时会报 Could not create remote directory；填错后者，直接提示 Cannot determine Python version。
立即学习“Python免费学习笔记（深入）”；
远程解释器下 pip install 失败，大概率是没激活虚拟环境或权限不足
如果你用的是 conda 或 venv，PyCharm 默认不会自动 source 环境。它只认你填的那个 python 路径，而那个路径可能指向系统 Python，而非你期望的虚拟环境里的 Python。
解决方法只有两个：
- 把
python路径直接指向虚拟环境内的解释器，比如/home/user/venv/bin/python（注意：这个路径必须真实存在，且venv已用python -m venv venv创建好） - 或者，在服务器上把虚拟环境的
bin加进全局PATH（不推荐），或改用 conda 的conda activate+ wrapper 脚本（复杂且易出错）
另外，远程 pip install 默认走的是服务器上的 pip，不是你本地的。如果服务器网络受限（比如没外网），PyCharm 会卡在“Installing packages…”不动，日志里出现 Connection to pypi.org timed out —— 这时候得配私有源或离线安装，和本地 pip 一样处理。
调试远程代码时断点不生效，检查 path mappings 是否严格匹配
远程调试依赖 PyCharm 把本地文件路径映射到服务器上的部署路径。如果映射错了，断点会灰掉，控制台显示 Breakpoint ignored because of missing file。
进入 Run → Edit Configurations → Defaults → Python Debug Server，确认：
- 本地项目根目录（如
/Users/me/project）映射到服务器上的Deployment path on server（如/home/user/myproject） - 路径结尾不要加斜杠，两边都必须是绝对路径，且大小写一致（Linux 区分大小写）
- 如果用了符号链接，PyCharm 默认不跟随，得在设置里勾选
Follow symbolic links
最常被忽略的是：你改了部署路径但忘了更新这里的映射，或者本地用的是相对路径（比如 ./src），PyCharm 根本解析不了。
