docker history 显示层数与实际镜像层不一致，因其默认折叠空操作、合并元数据且不显示构建缓存层；真实层数应以docker image inspect --format='{{json .rootfs.layers}}'输出为准。
docker history 显示的层数和实际镜像层不一致？
因为 docker history 默认折叠了空操作（如重复的 RUN 中只改注释）、合并了部分元数据层，且不显示构建缓存产生的中间层。真正决定镜像体积的是 docker image inspect --format='{{json .RootFS.Layers}}' 输出的 SHA256 列表 —— 每个元素对应一个不可变的 tar.gz 层。
实操建议：
- 用
docker image inspect <image></image>查RootFS.Layers，数准层数； - 用
docker save <image> | tar -t | head -20</image>看顶层文件路径，验证哪层塞了大文件； - 别信
docker history里标着 “0B” 的层——它可能只是没输出新文件，但 COPY 了 100MB 的venv/。
Python pip install 没加 --no-cache-dir 导致多出一层缓存？
默认情况下，pip install 在容器内会把 wheel 缓存写进 /root/.cache/pip（或 /tmp/pip-xxx），而这一目录若未被显式清理，就会固化为独立镜像层 —— 即使后续 RUN rm -rf /root/.cache 也删不掉，因为 Docker 层是只追加的。
常见错误现象：镜像比本地 pip install 多出 80–200MB，docker history 里找不到明显大层，但 RootFS.Layers 最后两层大小异常。
立即学习“Python免费学习笔记（深入）”；
实操建议：
- 所有
RUN pip install必须加--no-cache-dir； - 避免分多条
RUN安装依赖（如先apt-get再pip install），每条RUN都会产生新层； - 用
pip install --find-links <wheel-dir> --no-index --no-cache-dir</wheel-dir>预下载 wheel，彻底绕过网络和缓存逻辑。
多阶段构建中 Python 依赖层无法复用？
关键在 requirements.txt 的哈希稳定性：只要文件内容、换行符、注释位置稍有不同，Docker 就认为该层失效，重跑 pip install。更隐蔽的是，pip-tools 生成的 requirements.txt 默认带时间戳注释，每次生成都不同。
使用场景：CI 中频繁构建，期望复用 base 镜像 + 依赖层，只重建应用代码层。
实操建议：
- 用
pip-compile --generate-hashes --quiet --upgrade生成确定性requirements.txt； -
COPY requirements.txt .必须放在COPY . .之前，否则修改任意源码都会触发重装； - 不要在
requirements.txt里写-e .或git+https://—— 这些会让 Docker 无法判断是否命中缓存。
alpine + Python 的 so 文件残留问题
Alpine 上用 apk add python3 py3-pip 安装的 Python，其 site-packages 里混着大量 .so 和 .a 文件。这些不是运行必需的，但会被打包进镜像层，尤其当后续 pip install 编译 C 扩展（如 numpy）时，会连带把 build 工具链产物一起固化。
性能影响：单个 py3-numpy 包在 Alpine 镜像中常多出 40MB+，其中 30MB 是调试符号和静态库。
实操建议：
- 安装后立刻清理：
RUN apk del .build-deps && rm -rf /usr/lib/python*/site-packages/*/*.so /usr/lib/python*/site-packages/*/*.a； - 优先用
manylinuxwheel（pip install --only-binary=all），避开编译； - 确认
ldd依赖：对关键模块执行ldd $(python -c "import numpy; print(numpy.__file__)")，只保留真正 runtime 需要的 so。
最易被忽略的是：pip install 后的 /tmp/pip-* 目录，哪怕加了 --no-cache-dir，临时解压的 wheel 也可能留在 /tmp 并被固化 —— 记得在同一条 RUN 里 rm -rf /tmp/*。
