# 多阶段构建

**URL:** <https://buildx.do/t/%E5%A4%9A%E9%98%B6%E6%AE%B5%E6%9E%84%E5%BB%BA/63>\
**Category:** 云栈探研\
**Tags:** 容器技术\
**Created:** [2026 年10 月 4 日 06:11 UTC](https://buildx.do/t/%E5%A4%9A%E9%98%B6%E6%AE%B5%E6%9E%84%E5%BB%BA/63 "2026-10-04T06:11:00Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![zhaoan](https://buildx.do/letter_avatar_proxy/v4/letter/z/8edcca/32.png) [@zhaoan](https://buildx.do/u/zhaoan)\
**Post date:** [2026 年10 月 4 日 06:11 UTC](https://buildx.do/t/%E5%A4%9A%E9%98%B6%E6%AE%B5%E6%9E%84%E5%BB%BA/63/1 "2026-10-04T06:11:00Z")

</div>

「多阶段构建」。

最终镜像不再带着编译工具。小，也少一点多余的东西。

判断分两层。第一层是现象：什么时候开始、影响谁、能不能再出现。第二层才是原因。很多时间浪费在还没写清现象就改代码。原因确定之后，改动尽量小，并写明怎样一分钟内确认它生效。确认不了的改动先不要合。

镜像里不要留安装缓存，不要用 root 图省事。挂载为空时，把宿主机路径和容器路径都打印出来。端口先写明哪边对外。基础镜像版本写死，避免本地有的库线上没有。健康检查只用镜像里存在的命令。重启策略和数据卷一起看，机器重启后服务还在，才算配完。

先留现场，再动手。把当时的输入、输出、配置名抄下来，确认同一条路径还能再出现一次。不能再出现的现象，改完也不知道是不是改对了。确认之后只改一处。改两处的话，结果变了也分不清是哪一处。改完用同一组输入再走，结果要变成预期的那样，而不是仅仅没有报错。

复查「多阶段构建」时按这四步，不靠感觉。用改之前的同一组输入再走一遍，结果要变成预期的那样。在日志里打出实际读到的配置名、端口或库名，确认不是另一个还没关的进程。换一个干净环境再做一次。最后把现象、改动、确认方法写成三行放进仓库。

补充记录。镜像和运行分开看。构建阶段清掉安装缓存，最终镜像不带编译工具，不用 root。运行阶段写明对外端口、数据卷、重启策略。挂载进去是空的，就把两边路径都打印出来，多半是多了一层目录。健康检查只用镜像里真有的命令，命令不存在会一直失败，看起来像应用没就绪。基础镜像版本写死，避免本地有的库在服务器上没有。两个容器不能互相等对方先启动，把真正的依赖写出来，另一个改成可以稍后连接。机器重启后服务还在、数据还在，这份配置才算完。

操作顺序。1. 写明基础镜像的版本，不写 latest。2. 构建末尾清掉安装缓存，最终阶段不带编译工具。3. 进程不用 root，缺目录就补权限。4. 启动时打印对外端口、挂载路径和实际读到的环境变量名。5. 健康检查改成镜像里存在的命令。6. 写上重启策略，重启机器后确认进程和数据都还在。7. 两个容器若互相等待，改成一个可稍后连接。路径或端口看反，会表现为空目录或连不上，先核对打印出来的值。

---

<div class="post-metadata">

**Author:** ![wuqiao](https://buildx.do/letter_avatar_proxy/v4/letter/w/858c86/32.png) [@wuqiao](https://buildx.do/u/wuqiao)\
**Post date:** [2026 年10 月 4 日 07:04 UTC](https://buildx.do/t/%E5%A4%9A%E9%98%B6%E6%AE%B5%E6%9E%84%E5%BB%BA/63/2 "2026-10-04T07:04:00Z")

</div>

多阶段构建让最终镜像不带编译工具。体积小，多余的东西也少。
