c++oding="utf-8" ?>
c++项目需多阶段构建，因其编译链依赖gcc、cmake等数百mb开发组件，而运行时仅需libc等共享库；多阶段构建通过builder阶段完成编译、runtime阶段仅复制可执行文件及必要依赖，实现体积缩减与安全加固。
多阶段构建在 c++ 项目中本质是用 docker 隔离编译环境与运行环境，把“编译链”（预处理→编译→汇编→链接）完整留在构建阶段，最终镜像只保留可执行文件和必要运行时依赖，不带任何编译工具、头文件或中间目标文件。
为什么 C++ 需要多阶段构建
C++ 编译链依赖完整工具链（GCC、CMake、标准库头文件等），而运行时只需 libc、libstdc++ 等共享库。若直接用 g++ 构建并打包，镜像会包含 gcc、make、cmake 等数百 MB 的开发组件，既增大体积，又增加攻击面。多阶段构建通过分层剥离，解决这个问题。
典型两阶段 Dockerfile 结构
以一个基于 CMake 的 C++ 项目为例：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
第一阶段（builder）：使用
ubuntu:24.04或gcc:12镜像，安装build-essential、cmake、pkg-config等，执行cmake && make，生成可执行文件（如/app/build/myapp） -
第二阶段（runtime）：使用轻量级镜像（如
ubuntu:24.04-slim或debian:bookworm-slim），仅复制第一阶段生成的二进制文件和必需的共享库（可用ldd检查依赖），不安装任何编译器
关键操作细节
避免常见陷阱需注意：
- 用
COPY --from=builder /app/build/myapp /usr/local/bin/myapp显式指定源路径，确保复制的是已链接完成的可执行文件，而非未 strip 的 debug 版本 - 若程序依赖非系统默认库（如自编译的
libprotobuf.so），需一并复制到 runtime 阶段，并设置RUN ldconfig或通过LD_LIBRARY_PATH声明路径 - 对 release 构建，建议在 builder 阶段加
-DCMAKE_BUILD_TYPE=Release -DNDEBUG，并用strip减小二进制体积 - 可结合
docker build --target builder单独调试构建阶段，验证编译是否成功
与本地 Makefile/CMake 的协同
多阶段构建不替代 Makefile，而是复用其逻辑：
- Dockerfile 中的
cmake .. && make -j$(nproc)实际调用的就是项目根目录下的CMakeLists.txt - Makefile 中定义的
CXXFLAGS、INCLUDE_DIRS仍生效；Docker 只提供一致的构建上下文 - 推荐将构建参数（如
-std=c++17、-O2）统一写在CMakeLists.txt里，而非硬编码在 Dockerfile 中，提升可维护性
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
