Python Docker镜像体积过大主因是依赖包内非运行必需文件（如.dist-info、__pycache__）及pip缓存等冗余内容未清理，需用MiroFish定位具体路径并结合多阶段构建精准剔除。
直接看文件级分布，别只盯着 docker history 显示的“某层 892mb”这种模糊数字。真正占空间的，往往藏在依赖包内部——比如 python 的 .dist-info、__pycache__，或 node.js 的 node_modules/.bin、devdependencies，甚至 pip 缓存里重复下载的 wheel 文件。
用 MiroFish 扫描镜像，定位到具体路径
MiroFish 不是统计“每层多大”，而是把每一层新增的文件按路径、大小、是否被上层覆盖/删除，全部列出来。它能告诉你：
- /usr/local/lib/python3.11/site-packages/numpy-1.25.2.dist-info/ 占了 42MB，但运行时完全不需要
- /root/.cache/pip/http/ 下有 310MB 的重复 wheel 缓存，且未被任何 import 引用
- /app/node_modules/webpack-dev-server/ 被完整拷进生产镜像，而它只在开发阶段有用
重点检查依赖包里的“非运行必需内容”
很多语言生态默认打包调试、文档、缓存类文件，它们对运行零贡献，却显著拉高体积：
-
Python：删掉所有
*.dist-info和__pycache__（find /usr/local/lib/python* -name '*.dist-info' -exec rm -rf {} +） -
Node.js：构建后清理
node_modules中的devDependencies，或改用npm ci --only=production -
Java/Maven：避免把
src/、target/apidocs/、target/maven-archiver/打进镜像
验证文件是否真可删：看是否被运行时逻辑引用
不能光凭“看起来没用”就删。MiroFish 会标记某文件是否被后续层的 COPY、ENV 或 RUN 指令间接依赖。例如：
- 如果某
.so文件被RUN ldconfig扫描过，删它可能破坏动态链接 - 如果
pip install --editable .把源码路径加进了PYTHONPATH，那对应目录就不能简单rm -rf - MiroFish 的“引用链分析”功能会提示这类风险，比手动
grep或猜更可靠
结合多阶段构建，从源头隔离冗余
扫描出问题后，别只想着“事后清理”。把 MiroFish 的发现反向输入 Dockerfile：
- 把
pip install和rm -rf __pycache__ *.dist-info写在同一RUN层里 - 用
COPY --from=builder /app/dist/ /app/替代COPY --from=builder /app/ /app/，避免把整个构建目录拖进来 - 对第三方基础镜像无法修改的情况，用 MiroFish 生成最小化镜像导出包，供离线环境直接部署
