pycharm连接容器调试

pycharm连接容器调试

环境准备

• pycharm 2026.1.4
• docker-desktop v4.80.0
• 基础镜像

步骤

1. 运行docker-desktop、pycharm ；

2. 打开pycharm ，右上角点击设置按钮，在设置窗口中找到docker，点击+，配置如下：
   

3. 准备镜像，Dockerfile，使用docker build -t python-env .内容如下：

# 使用轻量级的 Python 官方镜像 FROM python:3.10.12-slim # 设置环境变量：防止 Python 缓冲输出（让 PyCharm 控制台实时打印日志） ENV PYTHONUNBUFFERED=1 # 安装编译工具（和 Python 开发头文件） RUN apt-get update && apt-get install -y gcc build-essential python3-dev && rm -rf /var/lib/apt/lists/* # 设置工作目录（容器内部的代码存放路径） WORKDIR /app # 关键优化：先只复制依赖文件，利用 Docker 缓存层，避免每次改代码都重新装包 COPY requirements.txt . # 安装 Python 依赖（使用清华源加速，如果不需要可删掉 -i 部分） RUN pip install --no-cache-dir -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple # 最后复制项目所有代码到镜像中（PyCharm 挂载卷会覆盖此目录，这行主要用于命令行直接运行） COPY . . # 容器启动时执行的默认命令（可被 PyCharm 覆盖） CMD ["python", "app.py"]

requirements.txt内容如下：

fastapi>=0.110.0 uvicorn[standard]>=0.27.0 numpy>=1.24.0 pydantic-settings>=2.0.0 cython>=3.0.0

4. 准备docker-compose文件，放在根目录，内容如下：

services:model-server:image:python-env:latestcontainer_name:py-devports:-"8000:8000"# 这就是端口映射volumes:-.:/app# 挂载代码，方便实时修改

5. 找到interpreter，点击右侧Add Interpreter，选择on docker compose
   

6. 一般会自动识别docker-compose.yml文件，截图如下：
   

7. 点击下一步即可。
   

完成！