PyCharm远程同步需同时配置SSH Configuration、Remote Interpreter和Deployment Mapping三者，缺一不可；Test Connection成功仅表示SSH登录可达，并不启用自动上传，必须手动开启Tools→Deployment→Options中的“Upload changed files automatically”并正确设置路径映射与权限选项。
PyCharm 远程同步代码不是“连上就能用”，必须同时配对 SSH Configuration、Remote Interpreter 和 Deployment Mapping 三者，缺一不可。社区版完全不支持，专业版也常因路径填错或同步未启用导致本地改了代码、服务器纹丝不动。
为什么 Test Connection 成功但代码不上传？
这是最典型的误判场景：SSH 连通只代表能登录服务器，不代表代码同步已生效。Deployment 配置和 Sync folders 设置是独立开关，哪怕解释器都选对了，只要没在 Tools → Deployment → Options 里勾选 Upload changed files automatically to the default server，或者没设 Always 模式，改完 Ctrl+S 就只是保存本地文件。
- 检查右下角状态栏是否显示
SFTP+ 服务器地址，不显示说明Deployment没激活 -
Tools → Deployment → Configuration → Options中的自动上传策略必须手动开启，不能依赖默认值 - 映射路径（
Local path/Development path）必须通过点击文件夹图标选择，手输路径容易漏掉末尾斜杠或大小写错误
Remote Interpreter 路径填错的三种常见表现
解释器路径不对，轻则第三方库识别失败，重则运行直接报 ModuleNotFoundError 或 command not found: python。关键不是“有没有 Python”，而是 PyCharm 找到的那个 Python 是否真能加载你项目所需的环境。
- 用
which python或which python3查的是当前 shell 的 Python，但 PyCharm 启动时可能不加载你的.bashrc，所以推荐在目标 conda env 中执行：conda activate myenv && which python - 虚拟环境路径别只写到
/envs/myenv，必须精确到/envs/myenv/bin/python（Linux/macOS）或\envs\myenv\python.exe（Windows Server） - 如果用了
pyenv或asdf，路径通常在~/.pyenv/versions/3.x.x/bin/python，且需确认该 shell 下pyenv shell 3.x.x已生效
SSH 密钥认证失败时别急着换密码登录
密钥方式更安全，但 PyCharm 对私钥格式敏感。OpenSSH 9.0+ 默认生成的 ed25519 私钥，旧版 PyCharm（如 2022.x）可能不识别；而 PuTTY 格式的 .ppk 文件 PyCharm 完全不支持。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 生成兼容性更强的密钥：
ssh-keygen -t rsa -b 4096 -m PEM（-m PEM强制输出传统 PEM 格式） - 私钥文件权限必须是
600，否则 PyCharm 会静默拒绝加载（Linux/macOS 执行chmod 600 ~/.ssh/id_rsa） - 若服务器禁用了密码登录（
PasswordAuthentication no），而密钥又没配对成功，PyCharm 就会卡在连接界面无响应——此时应先用终端ssh -i ~/.ssh/id_rsa user@host验证是否真能免密登录
同步后远程文件权限变 600 或中文乱码怎么办？
PyCharm 默认用 SFTP 协议上传，但部分服务器的 SFTP 子系统（如某些 OpenSSH 版本或 Docker 容器内）不继承 umask，或未正确设置字符编码，导致上传后脚本无法执行、日志中文变问号。
- 在
Tools → Deployment → Options中关闭Preserve timestamps和Preserve permissions，让文件以服务器默认权限落地 - 若远程 Python 报
PermissionError: [Errno 13] Permission denied，登录服务器手动chmod +x *.py并检查ls -l输出的权限位 - 中文乱码多因服务器 locale 未设为
en_US.UTF-8或zh_CN.UTF-8，执行locale查看，缺失则运行sudo locale-gen zh_CN.UTF-8 && sudo update-locale（Ubuntu）
远程同步真正卡点不在“怎么连”，而在“连上之后谁管路径、谁管权限、谁管环境加载顺序”。Deployment Mapping 和 Remote Interpreter 看似并列配置，实则后者决定运行时环境，前者决定代码落盘位置——两个路径指向不同目录，就等于在两台机器上跑同一份代码。
