docker build --squash 从 Docker 20.10 开始被彻底移除，执行报错 unknown flag: --squash；替代方案为多阶段构建（推荐）或 docker export + import（丢失元数据，需手动恢复）。
docker build --squash 在 Docker 20.10+ 已被废弃，别再用了
直接说结论：docker build --squash 从 Docker 20.10 开始被移除，现在执行会报错 unknown flag: --squash。这不是配置没开、插件没装的问题，是官方彻底删了。强行降级 Docker 版本不仅带来安全风险，还会和现代构建工具（如 BuildKit）冲突。
替代方案只有两个方向：用 BuildKit 的多阶段构建做“逻辑层合并”，或用 docker export + docker import 做“运行时层塌缩”——后者有副作用，但有时不得不选。
多阶段构建（multi-stage build）才是推荐的体积控制手段
它不真合并镜像层，而是让构建中间产物不出现在最终镜像里，效果等价于“只保留最后一步的文件系统快照”。关键是写法简单、兼容性好、BuildKit 默认启用。
- 第一阶段用
golang:1.22编译二进制，第二阶段用alpine:3.20只 COPY 可执行文件 - 避免在最终镜像里残留
/usr/src/app、node_modules、go/pkg这类构建依赖 - 注意
COPY --from=builder必须指定阶段名，不能只写序号（比如--from=0），否则切换基础镜像后容易断链 - 如果用了
RUN apt-get install -y ... && rm -rf /var/lib/apt/lists/*，这种“安装+清理”写在同一行才能真正减少层数；分两行写，清理操作会被单独成层，体积没变
docker export + docker import 是唯一能物理合并层的方法
它把容器文件系统导出为 tar 流，再导入成新镜像，结果只有一个层。但代价明显：丢失所有元数据（ENV、EXPOSE、HEALTHCHECK、ENTRYPOINT 全没了）。
实操必须补全这些信息：
- 先
docker create --name temp my-app:build创建容器（别用run，避免进程退出导致状态不可控） - 再
docker export temp | docker import - my-app:squashed - 最后
docker tag和docker commit都不行，得用docker image inspect看空镜像 ID，再docker image tag <id> my-app:squashed</id> - 手动恢复元数据：
docker commit --change 'ENV PATH=/usr/local/bin' --change 'EXPOSE 8080' <container-id> my-app:squashed</container-id>
这个流程没法自动化进 CI，每次都要人工核对 inspect 输出，一漏就跑不起来。
buildkit 的 export-cache 不等于 squash，别混淆
docker buildx build --cache-to type=registry 存的是构建缓存，不是镜像层。它不会让单个镜像变小，只是下次构建时复用中间层更快。有人误以为开了 DOCKER_BUILDKIT=1 就自动压缩，其实完全无关。
真正影响体积的只有两件事：你 COPY 进去什么，以及每一层 RUN 操作是否把垃圾留在了文件系统里。哪怕用了 BuildKit，RUN apt-get update && apt-get install curl 后没清 /var/lib/apt/lists，那层照样胖。
最易忽略的一点：COPY 大文件（比如 node_modules.tar.gz）再解压，比直接 COPY 解压后的目录更占空间——因为压缩包和解压内容会同时存在于某一层中，直到下一层删除压缩包才算释放。不如先 tar -xzf 再 COPY . /app。
