应优先选用官方 slim 或 bookworm Python 镜像，通过分层安装、多阶段构建、精简清理和非 root 用户等手段优化镜像体积与安全性。
选择合适的基础镜像
优先使用官方 Python 镜像（如 python:3.9-slim 或 python:3.11-bookworm），避免基于 full Debian/Ubuntu 的臃肿镜像。slim 版本已剔除编译工具和文档，体积更小、攻击面更少；若需编译 C 扩展（如 psycopg2、cryptography），可临时用 python:3.11-bullseye + build-essential，但最终应多阶段构建剥离编译环境。
分层安装依赖，利用缓存机制
Docker 构建时按变更频率从低到高排序指令，提升缓存复用率：
- 先复制 requirements.txt，再运行 pip install -r requirements.txt —— 仅当依赖文件变化才重装库
- 避免在单条 RUN 中混合安装系统包（apt）和 Python 包（pip），因任一变动都会使后续所有层失效
- 若依赖含私有源或频繁更新，可加 --no-cache-dir 防 pip 缓存干扰，但通常建议保留缓存以加速构建
精简安装，减少冗余文件
安装后立即清理 pip 缓存、文档和 .pyc 文件：
- pip install --no-cache-dir -r requirements.txt
- 追加命令：&& find /usr/local -depth -name __pycache__ -exec rm -rf {} + \
- 清除 pip 缓存：&& pip cache purge
- 卸载构建期不需要的包（如 setuptools、wheel）：用 pip uninstall -y setuptools wheel（仅当确认应用不依赖时）
使用多阶段构建彻底瘦身
将构建与运行分离，只把必要文件复制到最终镜像：
- 第一阶段：安装编译工具、源码、依赖，完成构建（如编译 Cython 模块、下载大模型权重）
- 第二阶段：基于 slim 镜像，仅复制 /usr/local/lib/python*/site-packages/ 和应用代码
- 显式指定用户：USER 1001，避免 root 运行，提升安全性
验证与调试技巧
构建完成后快速检查镜像健康度：
- 运行容器并进入：docker run -it your-image:tag sh
- 确认 Python 路径和版本：which python && python --version
- 检查关键库是否可导入：python -c "import numpy, requests"
- 用 docker history your-image:tag 查看各层大小，定位膨胀源头
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
