PyCharm通过Docker解释器（非运行配置）在容器中持久运行程序，需配置Server、Image name和Python interpreter path三项，并确保容器常驻（如tail -f /dev/null）、路径映射准确，方可支持调试与REPL。
PyCharm 能直接在 Docker 容器里运行程序，但不是“把本地 Python 解释器塞进容器”，而是让 PyCharm 启动一个容器、挂载代码、用容器里的 Python 执行——整个过程由 Docker 插件自动协调。关键在于：你得用对解释器类型，且容器启动后必须能持续运行（不能一执行完就退出）。
Docker 运行配置 vs Docker 解释器：别混用
很多人卡在这一步：看到“Docker”就点新建运行配置，结果 python main.py 一跑完容器就 stop，断开连接，PyCharm 报错 “interpreter not available”。这是因为：
-
Docker 运行配置（右上角 ▶️ → “Edit Configurations” → “+” → “Dockerfile” 或 “Docker Image”）适合一次性任务，比如构建镜像、跑测试脚本，容器默认执行完 CMD 就退出； -
Docker 解释器（Settings → Project → Python Interpreter → ⚙️ → Add → On Docker）才是用来长期运行、调试、REPL 的，它要求容器后台常驻（如tail -f /dev/null或sleep infinity），PyCharm 再通过 SSH 或直接 exec 连上去执行代码。
想在容器里 debug Flask 或 FastAPI？必须选后者。
Python Interpreter → On Docker：填对这三项才连得上
配置 Docker 解释器时，三个字段最容易填错：
-
Server：确认 Docker Desktop 正在运行，PyCharm 能自动识别 localhost:2375（Mac/Windows）或 unix:///var/run/docker.sock（Linux）。如果报 “Connection refused”，先docker info看是否正常； -
Image name：不要写python:3.11-slim这种基础镜像——它没装 SSH，也没预装你的包。要么用已 build 好的带依赖的镜像（如myapp:latest），要么用continuumio/miniconda3这类含 Conda 的镜像； -
Python interpreter path：路径必须绝对且真实存在。例如 Conda 环境要写/opt/conda/envs/myenv/bin/python，不是python或conda run -n myenv python；基础镜像则通常是/usr/local/bin/python——不确定就先docker run -it your-image which python查一下。
容器必须“活着”，否则 PyCharm 会反复重连失败
PyCharm 连 Docker 解释器时，会尝试执行 python -c "import sys; print(sys.version)"。如果容器启动即 exit，这个命令根本跑不起来。解决方法只有两种：
- 在
Dockerfile最后不用CMD ["python", "main.py"]，改用：CMD ["sh", "-c", "trap 'exit' INT TERM; tail -f /dev/null"]（推荐）； - 或者用
docker-compose.yml启动时加command: ["sleep", "infinity"]，后续再手动docker exec -it container-name python main.py； - 千万别依赖
docker run -it手动启的容器——PyCharm 不认这种临时容器，它只认自己通过解释器配置拉起的、有明确生命周期管理的实例。
挂载路径映射错了，代码修改不生效
配置完解释器后，PyCharm 会提示设置 Path mappings。这里不是可选项，是必填项：
- 左边填你本地项目根目录（如
/Users/name/project）； - 右边填容器内对应路径（如
/app），必须和WORKDIR或COPY目标一致； - 如果映射错位（比如本地
./src映射到容器/app，但代码实际在/app/src），PyCharm 保存文件时会写到错误位置，容器里读不到新代码； - 验证方式：在 PyCharm 里改一行
print("x")→ 保存 → 进容器docker exec -it container-name cat /app/main.py，看是否同步。
最常被忽略的是：Docker 解释器建立后，所有 Run/Debug 操作都走容器内 Python，但断点、变量查看、REPL 都依赖路径映射准确——差一个斜杠，调试就失效。
