Docker 小技巧：用多阶段构建把 Python 镜像瘦身 70%

问题

很多人用 python:3.11 官方镜像直接打包应用，镜像动辄 1GB 以上，拉取慢、攻击面也大。下面用多阶段构建把体积明显压缩。

做法

第一阶段在完整镜像里安装依赖并生成 wheel，第二阶段只拷贝运行所需文件，使用 slim 基础镜像：

# 构建阶段
FROM python:3.11 AS builder
WORKDIR /build
COPY requirements.txt .
RUN pip wheel --no-cache-dir --wheel-dir /wheels -r requirements.txt

# 运行阶段
FROM python:3.11-slim
WORKDIR /app
COPY --from=builder /wheels /wheels
RUN pip install --no-cache-dir /wheels/* && rm -rf /wheels
COPY . .
USER nobody
CMD ["python", "main.py"]

要点

1. 先单独 COPY requirements.txt 再安装依赖，源码改动时可以命中构建缓存。
2. pip 加 --no-cache-dir，避免把下载缓存留在镜像层里。
3. 加一个 .dockerignore，排除 .git、pycache、虚拟环境等无关文件。
4. 用 USER 切换为非 root 用户运行，更安全。
5. 用 docker images 对比前后体积，我的小项目从约 1.1GB 降到 150MB 左右。

如果依赖需要编译 C 扩展，可以在构建阶段安装 gcc，运行阶段不需要，这正是多阶段构建的价值。