直接用python:3.11-slim可砍掉60%以上体积，再加多阶段构建可压至200MB左右；slim镜像剔除gcc、man手册等冗余内容，仅保留glibc和Python运行必需组件，体积约120MB且兼容numpy等主流包，而Alpine因musl libc易致安装失败或运行时错误。
直接用 python:3.11-slim 就能砍掉 60% 以上体积，再加多阶段构建可进一步压到 200MB 左右——但别一上来就上 Alpine 或自编译 CPython，90% 的项目根本不需要，反而卡在 pip install 报错上。
选对基础镜像：slim 不是妥协，而是默认起点
官方 python:3.11 镜像含完整 Debian + 编译工具链，体积常超 900MB；python:3.11-slim 剔除了 gcc、man 手册、调试符号等，只保留 Python 运行必需的 C 库（glibc），体积约 120MB，且兼容绝大多数 PyPI 包（包括 numpy、psycopg2、cryptography）。
- 别盲目选
alpine：musl libc 导致tensorflow、pydantic等包安装失败或运行时 segfault，调试成本远高于节省的几十 MB - 别用
latest标签：必须锁定具体版本（如python:3.11-slim），否则某天构建突然失败，你得翻 changelog 找原因 - 验证方法：构建后执行
docker images | grep python，对比大小和创建时间
多阶段构建：只保留 site-packages 和代码，扔掉构建痕迹
单阶段 Dockerfile 会把 pip 缓存、临时编译产物、甚至 requirements.txt 原文件全打进最终镜像。多阶段构建让构建环境（builder）和运行环境彻底分离。
- 第一阶段用完整镜像（如
python:3.11-slim）装依赖，确保RUN pip install成功 - 第二阶段换同版本 slim 镜像，用
COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages复制已安装包 - 避免
COPY . .放在RUN pip install之后：否则每次改代码都会让 pip 缓存失效，重装所有依赖 - 示例关键段：
FROM python:3.11-slim AS builder COPY requirements.txt . RUN pip install --no-cache-dir -r requirements.txt FROM python:3.11-slim COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages COPY clean_data.py . CMD ["python", "clean_data.py"]
精简 RUN 指令：合并、清理、跳过缓存无意义操作
Docker 每个 RUN 指令都生成一层，层数越多，镜像越臃肿，缓存越难复用。关键是把“装依赖”和“清垃圾”锁死在同一层。
立即学习“Python免费学习笔记（深入）”；
- 把
apt-get update && apt-get install和rm -rf /var/lib/apt/lists/*写在同一行RUN中，否则中间层残留 apt 缓存 - Python 项目一般不用系统包管理器，所以这步常可省略；但如果
requirements.txt含需系统库的包（如mysqlclient），才加apt-get install default-libmysqlclient-dev - 强制禁用 pip 缓存：
--no-cache-dir必须加，否则 pip 会在镜像里留几百 MB 缓存目录 - 删测试模块（安全）：
RUN rm -rf /usr/local/lib/python3.11/test可减 15–20MB，不影响运行
容易被忽略的细节：.dockerignore 和路径 COPY
你以为只 COPY 了 clean_data.py？只要没写 .dockerignore，Docker 构建上下文会把整个目录（含 __pycache__、.git、venv）全塞进构建过程，拖慢速度、污染缓存、增大镜像。
- 必须创建
.dockerignore文件，内容至少包含：.git __pycache__ *.pyc venv .env .gitignore
-
COPY requirements.txt .要放在COPY . .之前：这样 pip 安装步骤就能利用缓存，改代码不触发重装 - 别用
COPY . /app：显式列出要复制的文件（如COPY clean_data.py requirements.txt .），避免意外带入大文件
最复杂的不是语法，是判断哪些包真需要编译、哪些系统库不能少、哪些测试文件删了会不会影响 import —— 每个项目得跑一遍 python -c "import xxx" 验证，而不是照抄模板。
