pycharm professional 版才支持 docker 解释器，community 版不支持；需启用 docker 插件、确保守护进程连通，并在解释器配置中明确指定容器内 python 可执行路径（如 /usr/local/bin/python），挂载与端口映射需在运行配置中单独设置。
PyCharm Professional 版本才能用 Docker 解释器；Community 版不支持，硬配也跑不起来。
确认 Docker 插件已启用且连接正常
PyCharm 默认捆绑 Docker 插件，但可能被手动禁用。进 Settings → Plugins 搜索 Docker，确保复选框已勾选。插件启用后，PyCharm 右下角状态栏应显示 Docker connected。若显示 Disconnected，检查：
• Docker Desktop 是否正在运行（macOS/Windows）或 dockerd 服务是否启动（Linux）
• PyCharm 是否有权限访问 Unix socket（Linux 常见问题，需将当前用户加入 docker 组）
• Windows WSL 用户注意：Docker Desktop 必须配置为使用 WSL2 后端，且 PyCharm 要连接到 unix:///var/run/docker.sock 或通过 WSL2 的 TCP 端口（不推荐）
添加 Docker 解释器时必须指定 Python 可执行路径
在 Settings → Project → Python Interpreter → Add Interpreter → On Docker 中，选择镜像后，PyCharm 不会自动猜出 Python 解释器位置——尤其是 Conda 或自定义环境。常见路径包括：
• 官方 python:3.9 镜像：/usr/local/bin/python
• continuumio/miniconda3 + 环境 myenv：/opt/conda/envs/myenv/bin/python
• 使用 pyenv 构建的镜像：/root/.pyenv/versions/3.10.12/bin/python
填错会导致解释器加载失败，报错信息通常是 Python interpreter not found 或 Failed to get interpreter info。建议先 docker run -it <image> which python</image> 确认路径。
挂载项目目录不是自动的，得靠“解释器配置”触发
很多人以为只要连上容器，代码就同步了——其实不然。PyCharm 只在配置 Docker 解释器时，才把当前项目根目录作为 volume 挂载进容器，默认挂载点是 /workspace（可改）。关键点：
• 这个挂载只对解释器生效，不影响你手动创建的容器或 docker run 命令
• 如果你在容器里 pip install 包，它们会留在容器文件系统中，但下次用该解释器配置重启容器时，这些包仍存在（因为镜像是基础，容器层保留）
• 但如果你删掉容器重来，又没 commit 镜像，那些包就丢了
• 想持久化依赖，应该写进 Dockerfile 或用 requirements.txt + RUN pip install，而不是依赖容器层临时修改
调试容器内进程时，端口和卷绑定不继承解释器配置
PyCharm 的 Docker 解释器只管 Python 执行和代码同步，它不控制容器的网络或存储配置。比如你想调试一个 Flask 应用并访问 localhost:5000：
• 单纯配了解释器，app.run(host='0.0.0.0:5000') 会启动，但宿主机打不开——因为没暴露端口
• 必须额外在运行配置里加端口映射：右键运行配置 → Edit Configurations → Docker container settings → Port mappings，填 5000:5000
• 同理，想挂载数据库卷或配置文件，得在同一个运行配置里手动加 Volume bindings，不能指望解释器设置自动带过去
• 这些配置不会写回 Dockerfile，每次新建运行配置都要重设
最易忽略的是：Docker 解释器配置和容器运行配置是两套独立系统。前者决定“用哪个 Python 跑代码”，后者决定“容器怎么启”。混用或默认跳过后者，调试时大概率卡在连不上、读不到文件、端口被拒绝这些地方。
