应使用 python:3.11-slim 而非 alpine，因其基于 glibc 兼容主流 PyPI 包；采用多阶段构建分离 builder 与 runtime 阶段；pip install 必加 --no-cache-dir 并合并清理操作；Dockerfile 中需锁定基础镜像 digest 以确保可复现性。
直接用 python:3.11-slim 作为基础镜像，配合多阶段构建和依赖分层控制，就能稳定压到 200MB 左右——别一上来就碰 alpine，musl libc 导致 numpy、psycopg2 或 pydantic 安装失败或运行时 segfault 的调试成本，远高于省下的几十 MB。
为什么不能用 python:3.11-alpine？
Alpine 镜像虽小（约 50MB），但底层是 musl libc，而绝大多数 PyPI 包（尤其是含 C 扩展的）只测试并兼容 glibc。常见表现：
-
pip install torch直接报错："ERROR: Could not find a version that satisfies the requirement torch" - 装上后运行时报
ImportError: /usr/lib/libc.musl-x86_64.so.1: invalid ELF header -
cryptography编译失败，提示ffi.h not found（因 Alpine 缺少对应 dev 包且命名不一致）
除非你明确验证过所有依赖都支持 musl（比如纯 Python 包 + 显式提供 Alpine wheel），否则默认绕开 alpine 更省时间。
多阶段构建必须拆开 builder 和 runtime
单阶段 Dockerfile 会把 pip 缓存、编译中间产物、甚至 requirements.txt 原文件全打进最终镜像，徒增体积且暴露敏感信息。
正确做法是两阶段分离：
- 第一阶段（
builder）：用完整python:3.11-slim，COPY requirements.txt后执行RUN pip install --no-cache-dir -r requirements.txt - 第二阶段（
runtime）：换同版本python:3.11-slim，仅COPY --from=builder /usr/local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages - 再
COPY应用代码，CMD启动
这样最终镜像里只有 site-packages 和你的代码，无构建痕迹，也规避了 COPY . . 放在 RUN pip install 后导致每次改代码都重装依赖的问题。
pip install 必须加 --no-cache-dir 且合并清理操作
--no-cache-dir 不只是减体积，更是防缓存污染——尤其在 CI 环境中，不同分支共用构建节点时，旧缓存可能引发不可复现的安装行为。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
同时，Docker 每个 RUN 指令生成一层，中间残留的临时文件会永久留在镜像里。例如：
RUN apt-get update && apt-get install -y gcc \
&& pip install --no-cache-dir -r requirements.txt \
&& apt-get clean && rm -rf /var/lib/apt/lists/*
必须把 apt-get clean 和 rm -rf /var/lib/apt/lists/* 写在同一行 RUN 中，否则前一层残留的包索引仍占几十 MB。
别用 latest 标签，锁定 python:3.11-slim 具体 digest
python:3.11-slim 是标签，不是固定镜像。某天它可能指向新版 Debian，导致 glibc 升级、SSL 证书路径变更或 psycopg2 动态链接失败。
安全做法是查当前 digest：
docker pull python:3.11-slim
docker inspect python:3.11-slim --format='{{.RepoDigests}}'
拿到类似 python@sha256:610ede222c1fa9675c694c99429f8d2c1b4e243f1982246da9e540eb5800ee4a 的值，Dockerfile 中写死它：
FROM python@sha256:610ede222c1fa9675c694c99429f8d2c1b4e243f1982246da9e540eb5800ee4a AS builder
这才是真正可复现的生产镜像起点——体积可控、依赖确定、升级主动，而不是某次构建突然失败后翻 changelog 找原因。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
