C++项目特别需要多阶段构建，因其编译依赖繁多（如GCC、CMake、Boost、OpenSSL），而运行时仅需二进制及少量共享库；单阶段镜像体积常超1GB，且含调试工具、源码等安全风险，违背最小权限原则。
多阶段构建是 C++ 项目 Docker 化的核心实践，它把编译和运行彻底分开，让最终镜像干净、轻量、安全。
为什么 C++ 项目特别需要多阶段构建
C++ 编译依赖多（GCC、CMake、Boost、OpenSSL 等），但运行时通常只需要二进制文件和极少数共享库。如果把编译器和源码全打进生产镜像，不仅体积暴涨（常超 1GB），还带来安全风险和部署延迟。
- 单阶段镜像容易包含调试工具、凭证、临时文件甚至源码
- 不同环境（开发/测试/生产）混用同一镜像，违反最小权限原则
- CI 流水线拉取大镜像慢，推送也耗带宽
标准两阶段写法（推荐入门用）
一个清晰、可复用的结构如下：
# 阶段1：构建 —— 用完整工具链编译 FROM gcc:13 AS builder WORKDIR /app COPY . . RUN mkdir -p build && cd build && cmake .. -GNinja && ninja <h1>阶段2：运行 —— 只保留可执行文件和必要运行时库</h1><p>FROM ubuntu:22.04 RUN apt-get update && apt-get install -y libboost-system1.74.0 libssl3 && rm -rf /var/lib/apt/lists/* WORKDIR /root COPY --from=builder /app/build/myapp . CMD ["./myapp"]
- builder 阶段负责所有构建动作：安装依赖、配置、编译、链接
- 运行阶段基础镜像选 Ubuntu 22.04 或 Debian bookworm，它们默认支持 C++20，且 libc 兼容性好
- COPY --from=builder只复制最终生成的二进制，不带源码、头文件或中间对象
进阶技巧：减小体积 + 提升安全性
生产环境建议进一步精简：
立即学习“C++免费学习笔记（深入）”；
- 运行阶段改用
ubuntu:22.04-slim或debian:bookworm-slim，体积比完整版小 30%～50% - 对二进制做 strip：在 builder 阶段末尾加
RUN strip --strip-unneeded build/myapp - 若程序不依赖动态 Boost/SSL，可静态链接：
cmake .. -DBUILD_SHARED_LIBS=OFF，之后运行阶段连 apt 安装都省了 - 敏感操作（如密钥读取、证书加载）放在容器启动时通过 volume 或 secrets 注入，而非打包进镜像
常见适配场景
根据项目实际灵活调整阶段逻辑：
-
含第三方子模块（如 git submodule）：在 builder 阶段先
RUN git submodule update --init -
交叉编译（ARM64 服务端）：builder 阶段用
gcc:13-aarch64-linux-gnu，运行阶段仍用ubuntu:22.04（注意目标平台匹配） -
需要运行单元测试：在 builder 阶段
RUN ctest -j4，失败则中断构建，不进入下一阶段 -
生成多个可执行文件：用
COPY --from=builder /app/build/*.out .批量复制，或按需指定路径
