pycharm远程开发需手动验证conda环境解释器真实路径、严格配置sftp映射及自动上传规则，否则易因路径错误、目录未创建或文件不同步导致modulenotfounderror或importerror。
PyCharm连接远程服务器不是配个IP和密码就完事，真正卡在中间的往往是解释器路径写错、映射没生效、文件不同步却毫无提示——这些细节直接导致代码在本地跑通、上传后报ModuleNotFoundError或ImportError。
确认远程Python解释器真实路径
别信服务器上which python3返回的结果——conda环境里它常指向base环境，而你实际要用的是某个特定env里的python。先SSH登录服务器，激活目标环境：conda activate myenv，再执行which python，复制完整输出路径，例如/home/user/miniconda3/envs/myenv/bin/python。
这一步必须手动验证，PyCharm界面里“自动探测”功能在多环境共存时大概率失效，会把base环境路径当默认值填进去。
【路径中不能含空格或中文】否则PyCharm后续同步失败且不报明确错误，只在日志里显示“interpreter not found”。
配置SFTP部署映射（关键同步环节）
进入 File → Settings → Build, Execution, Deployment → Deployment，点击+新建配置，类型选SFTP。
填写主机、端口、用户名，认证方式选Key pair并指定本地私钥路径（如~/.ssh/id_rsa），点击Test Connection确保绿色对勾出现。
切换到Mappings选项卡：左边Local path填你本地项目的根目录（比如/Users/alex/project/hkdl），右边Deployment path填服务器上对应目录（如/home/user/project/hkdl）。注意：这个远程路径必须已存在，PyCharm不会自动创建父级目录。
若远程路径不存在，先SSH上去手动执行mkdir -p /home/user/project/hkdl，否则后续上传直接静默失败。
启用自动上传与冲突处理
回到Deployment主界面，勾选Upload external changes，并在Options页签下设置：
PyCharm 2026.2提供 JetBrains 官方 2026.2 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
① On frame deactivation → 选Upload files to the default server
② On explicit save action → 选Upload changed files automatically
③ 在Excluded Paths里添加__pycache__、.git、.idea，避免无意义同步拖慢速度。
这三项必须同时启用，否则改完代码点运行，PyCharm仍执行本地旧版本——因为文件根本没传过去。
如果服务器上已有同名文件，PyCharm默认覆盖；但若你本地删了某.py文件，远程不会自动删除，得手动勾选Delete remote files when local files are deleted才生效。
调试时绕过SSH隧道直连GPU进程
方法一：用Run → Edit Configurations → Add New Configuration → Python，Interpreter选已配置好的远程解释器，然后在Environment variables里加CUDA_VISIBLE_DEVICES=0（按需修改ID）。
方法二：更稳妥的做法是，在服务器上提前启动一个监听端口的调试服务：python -m debugpy --listen 0.0.0.0:5678 --wait-for-client train.py，然后在PyCharm里新建Python Debug Server配置，Host填服务器内网IP（非公网IP），Port填5678。
注意：方法二要求服务器防火墙放行5678端口，且PyCharm本机网络能直通该IP；若走NAT或跳板机，优先选方法一。
