多阶段构建实现多语言混合项目联合打包，核心是按语言职责分阶段、用容器隔离环境、靠产物传递衔接：c/c++/rust编译核心库，python/java/go调用或编译业务逻辑，胶水层封装跨语言接口，最后组装运行包并验证调用。
分阶段设计：按语言能力切分责任
不同语言承担不同角色，阶段划分要匹配实际分工：
- C/C++/Rust 阶段：专注编译高性能核心库（如.so、.dll、静态.a），输出头文件和二进制；不装 Python 或 Node 工具链
- Python/Java/Go 阶段：只负责调用上一阶段产出的库，或编译自身业务逻辑（如 Pydantic 模型、Spring Boot JAR）；不保留编译器
- 胶水集成阶段：用 pybind11 / JNI / CGO 加载并封装跨语言接口，生成最终可调用模块（如 _core.cpython-*.so 或 libbinding.so）
- 运行包组装阶段：合并所有语言产物（JS bundle、Python wheel、Java JAR、C shared lib）、配置文件和启动脚本，打包为 tar/deb/docker 等交付格式
关键衔接：跨阶段复制与路径对齐
各阶段之间不共享文件系统，必须显式声明哪些产物要传递过去：
- 用 COPY --from=stage-name 复制指定阶段生成的文件，例如：
COPY --from=cpp-builder /usr/local/lib/libengine.so /app/lib/ - 确保路径一致：C 库安装到
/app/lib，Python 的setup.py或pyproject.toml就要指定library_dirs=["/app/lib"] - 避免硬编码绝对路径；优先使用相对路径或环境变量（如
LD_LIBRARY_PATH=/app/lib）
统一构建入口：用脚本或 Makefile 编排流程
单个 Dockerfile 难以覆盖所有语言细节，推荐外层用可复用的构建脚本驱动：
- 写一个
build.sh，依次执行：
→ 运行 CMake 构建 C 模块（输出到./build/cpp）
→ 启动 Python 容器，安装依赖并构建 wheel（读取./build/cpp中的 .so）
→ 调用 Maven 打包 Java SDK（引用已生成的 jar 或 proto 文件）
→ 最后用 fpm 或 docker build 组装最终包 - 每个子步骤可独立缓存、调试和测试，失败时无需重跑全部语言环节
制品归档与验证：确保混合包真正可用
联合打包完成后，不能只看体积变小了，要验证跨语言调用是否畅通：
- 在最终镜像中运行最小验证脚本：
→ Python 导入模块并调用 C 函数
→ Java 加载 JNI 库并执行计算
→ Node.js 通过 node-ffi-napi 调用同一份 .so - 把验证逻辑写成 CI 步骤，失败即中断发布
- 归档时保留各阶段中间产物（如
build/cpp/libengine.so、dist/mylib-1.0-py3-none-any.whl），便于回溯和复现
