优先选 python:3.9-slim（glibc兼容、体积约110MB），再考虑 python:3.9-alpine（仅5MB但需手动处理musl编译依赖）；务必检查wheel是否支持-musllinux_*，避免源码编译导致体积反弹，并合理使用.dockerignore和分层优化。

直接换 python:3.9-alpine 或 python:3.9-slim，能砍掉 60%–95% 的镜像体积，但得先确认你的依赖是否真能跑通——尤其是带 C 扩展的包。

为什么 Alpine 镜像小，但不是所有 Python 包都兼容

Alpine 使用 musl libc 而非 glibc，而很多 Python 包（如 psycopg2、numpy、scikit-learn）预编译的 wheel 只提供 glibc 版本。直接 pip install 会触发源码编译，此时必须装 gcc、musl-dev 等，体积反而可能比 slim 还大。

• 优先试 python:3.9-slim：基于 Debian，glibc 兼容性好，体积约 1GB → 降为 ~110MB
• 再试 python:3.9-alpine：基础层仅 ~5MB，但需手动处理编译依赖和 wheel 兼容问题
• 检查包是否提供 alpine wheel：访问 PyPI 页面，找 -musllinux_* 或 -manylinux_* 标签（后者在 Alpine 上可能不运行）

用 psycopg2 举例：slim vs alpine 的实际差异

在 python:3.9-slim 中，pip install psycopg2-binary 直接生效；但在 python:3.9-alpine 中，psycopg2-binary 不含 musl 支持，必须改用 psycopg2（源码安装）或切换到 psycopg2cffi。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• slim 下一行搞定：RUN pip install psycopg2-binary
• alpine 下需多步：RUN apk add --no-cache postgresql-dev gcc musl-dev && pip install psycopg2
• 注意：apk add 安装的 dev 包不会自动卸载，必须在同一 RUN 层中清理，否则残留进镜像

构建时别忽略 .dockerignore 和层顺序

即使换了小基础镜像，如果 .dockerignore 没配好，node_modules、.git、__pycache__ 这些仍会被 COPY 进来，白费功夫。

• 必须包含：.git、__pycache__、*.pyc、venv、.env、tests/
• COPY 依赖文件要早于源码：COPY requirements.txt . → RUN pip install -r requirements.txt → COPY . .，否则 pip 缓存失效，每次重装
• 避免分多个 RUN 安装依赖再删构建工具：合并在一层里，例如 RUN apt-get update && apt-get install -y build-essential && pip install ... && apt-get remove -y build-essential && rm -rf /var/lib/apt/lists/*

验证镜像到底“瘦”在哪，别只看 docker images

docker images 只显示最终大小，看不出哪层偷偷塞了 300MB 的 node_modules 或调试工具。真正的问题往往藏在中间层里。

• 用 docker history <image></image> 查每层大小，定位异常膨胀的 RUN 指令
• 更推荐用 dive <image></image>：交互式展开每一层，直接看到哪些文件占空间、是否被后续层删除却未释放
• 特别留意：pip install --user 会把包装进 /root/.local，该路径常被忽略，无法被 apt-get clean 清理

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！