用多阶段构建+python:x-slim镜像+精确复制可将1gb+镜像压缩至约100mb，ci/cd构建时间减少50%以上；因单阶段常全量打包开发环境，含编译工具、测试文档、缓存及中间产物等冗余内容。
直接结论：用多阶段构建 + python:x-slim 镜像 + 精确复制，能把 1GB+ 的镜像压到 100MB 左右，CI/CD 构建时间通常减少 50% 以上。
为什么单阶段 Dockerfile 会生成 1GB+ 镜像？
典型反模式是把开发环境全量打包进去：FROM python:3.11 启动后直接 RUN apt-get install gcc、COPY . .、RUN pip install -r requirements.txt。结果镜像里塞进了：
- gcc/g++/make 等编译工具（运行时完全不需要）
- 所有
.git、tests/、docs/、__pycache__文件 - pip 缓存和未清理的 APT 包索引（
/var/lib/apt/lists/*） - Python 源码、wheel 构建中间产物（如
build/、dist/）
这些内容加起来轻松突破 800MB，且每次代码变更都会让整个依赖安装层失效，缓存形同虚设。
多阶段构建的关键写法与参数取舍
核心是拆成 builder 和 runner 两个阶段，只在 builder 里装构建依赖，再精准复制产物到 runner：
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
# builder 阶段：专注编译和安装 FROM python:3.11-slim AS builder WORKDIR /app COPY requirements.txt . # 安装系统级编译依赖（仅此阶段需要） RUN apt-get update \ && apt-get install -y --no-install-recommends build-essential libffi-dev libssl-dev \ && rm -rf /var/lib/apt/lists/* # 使用 --no-cache-dir 避免 pip 缓存污染 RUN pip install --no-cache-dir --user -r requirements.txt <h1>runner 阶段：极简运行时</h1><p>FROM python:3.11-slim WORKDIR /app</p><h1>只复制 builder 阶段生成的用户级 site-packages</h1><p>COPY --from=builder /root/.local /root/.local</p><h1>只复制源码中真正运行所需的文件（不是整个项目目录）</h1><p>COPY app.py config.py ./ # 显式列出，避免误拷 ENV PATH=/root/.local/bin:$PATH CMD ["python", "app.py"] </p>
注意几个关键点：
- 务必用
python:x-slim而非alpine—— 多数 Python 包（尤其含 C 扩展的）在 musl 下编译失败或运行异常，调试成本远超体积节省 -
--no-install-recommends和rm -rf /var/lib/apt/lists/*必须成对出现，否则 APT 缓存残留几十 MB -
--user安装方式比虚拟环境更轻量，且COPY --from=builder /root/.local能完整保留二进制扩展模块路径 - 不要
COPY . .，显式声明运行所需文件；若用 Poetry，应COPY pyproject.toml poetry.lock ./后在 builder 中poetry install --no-dev
容易被忽略的构建上下文与缓存陷阱
即使 Dockerfile 写对了，构建命令和上下文错误也会让优化失效：
-
docker build .会把当前目录下所有文件（包括.git、node_modules）打包进构建上下文 —— 改用.dockerignore显式排除：.git、__pycache__、*.log、venv/ - 如果
requirements.txt在 COPY 之前就被修改，会导致 pip 安装层缓存失效 —— 把COPY requirements.txt放在最前，且确保它不随代码频繁变动 - 没启用 BuildKit 时，
--no-cache-dir对 pip 缓存控制有限 —— 推荐始终加上DOCKER_BUILDKIT=1环境变量启动构建 - 某些 C 扩展（如
psycopg2）在 slim 镜像里仍需libpq-dev，但该包不能留在最终镜像 —— 它只能出现在 builder 阶段，且要apt-get remove清理（或用--no-install-recommends规避）
最终镜像里不该有任何 apt、gcc、pip 命令，也不该存在 /usr/src/ 或 /tmp/pip-build- 这类临时路径 —— 这些都是验证是否真正瘦身成功的快速检查点。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
