Python Docker镜像体积过大主因是默认使用含冗余组件的Debian系基础镜像（如python:3.11达900MB），且未区分构建与运行阶段；通过多阶段构建（builder用slim、runtime用alpine）、精准COPY依赖、清理__pycache__/pyc/测试模块及禁用pip缓存，可将镜像从512MB降至约85MB。
为什么你的Python Docker镜像动辄500MB+？
因为默认用
或
这类官方镜像，底层是 Debian，自带大量系统工具、文档、调试符号和冗余 Python 模块（比如
、
的完整开发依赖）。哪怕只跑一个
hello world，基础层就占 400MB+。
多阶段构建：build 阶段只装编译依赖，runtime 阶段只留运行时文件
关键不是“分两个 FROM”，而是明确区分「需要编译」和「只需要执行」的边界。比如
、
、
等带 C 扩展的包，在 Alpine 上编译尤其耗时且易失败，必须在 build 阶段完成。
build 阶段用
（Debian 基础，兼容性好，pip 编译顺畅）
runtime 阶段用
（体积小，但不自带编译链）
用
只复制
和
下的代码，不复制
、
等中间产物
务必在 build 阶段末尾运行
，避免 pip 缓存被带入 runtime 镜像
Alpine 镜像下 Python 包安装失败？先看它缺什么
Alpine 用
替代
，没有
、
、
，很多包 pip install 直接报
或
。
如果必须用 Alpine 构建（而非仅 runtime），先
优先选
包：比如用
而非
，用
的 wheel 版本（检查 PyPI 页面是否提供
或
wheel）
避开硬依赖 glibc 的包，例如旧版
；改用
或
+
的 Alpine 兼容 fork
在 Alpine 上 pip install 极慢且常 OOM，建议在 builder 阶段装好再 COPY 过来
还能压多少？删掉 Python 自带的测试/文档/缓存
即使用了 Alpine，
镜像里仍包含
、
、帮助文档（
）、测试模块（
、
）和 pip 缓存目录。这些对运行服务毫无价值。
Python 3.14.3
微软官方的 Python 扩展，是 VS Code 安装量最高的扩展（209M+）。集成 IntelliSense（通过 Pylance）、调试（通过 Python Debugger）、代码检查、格式化、重构和单元测试等功能。支持 Jupyter Notebook、虚拟环境管理和多 Python 版本切换。
下载
立即学习
“
Python免费学习笔记（深入）
”；
构建末尾加清理命令：
删测试和 idle：
禁用 pip 缓存：
并确保所有
带
注意：不要删
外的
，那是 C 扩展必需的
实际项目中，从 512MB（
）降到 85MB（多阶段 + Alpine + 清理）很常见。但别为了省 5MB 强行删
模块或关验证——那会引发连接 HTTPS 接口失败这种线上静默故障。
python:3.9python:3.11tkintersqlite3flasknumpycryptographypsycopg2-binarypython:3.11-slimpython:3.11-alpine3.19COPY --from=builder/usr/local/lib/python3.11/site-packages//app/usr/src/var/cache/apkpip install --no-cache-dir -r requirements.txtFROM python:3.11-slim AS builder
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir --user -r requirements.txt
FROM python:3.11-alpine3.19
WORKDIR /app
COPY --from=builder /root/.local/lib/python3.11/site-packages /usr/local/lib/python3.11/site-packages
COPY . .
CMD ["python", "main.py"]musl libcglibcgccg++makeERROR: Command errored out with exit status 1fatal error: Python.h: No such file or directoryapk add --no-cache gcc g++ make musl-dev python3-dev*-binarypsycopg2-binarypsycopg2cryptographymanylinuxmusllinuxpyodbcpymssqlsqlalchemypyodbcnumpypython:3.11-alpine__pycache__.pycpydoctestidlelibRUN find /usr/local/lib/python3.11 -name '__pycache__' -delete && find /usr/local/lib/python3.11 -name '*.pyc' -deleteRUN rm -rf /usr/local/lib/python3.11/test /usr/local/lib/python3.11/idlelib /usr/local/lib/python3.11/pydoc_dataENV PIP_NO_CACHE_DIR=offpip install--no-cache-dirsite-packageslib-dynloadpython:3.11ssl