build2 与 C20 模块现代 C 模块构建的完整指南【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2C20 模块Modules是近年来 C 语言最大的变革之一但它给构建系统带来了前所未有的挑战模块需要按依赖顺序编译、要生成二进制模块接口BMI、还要处理标准库模块与头文件单元。build2正是为应对这些挑战而生的现代 C 构建系统。本文将带你快速掌握用 build2 构建 C20 模块项目的完整流程从基础概念到编译器支持差异一次讲清。为什么 C20 模块会让传统构建系统头疼传统头文件 预处理器的编译模型构建系统只需按文件依赖编译即可。而 C20 模块引入了全新的编译模型模块必须按依赖顺序编译被导入的模块必须先编译完成否则无法编译导入方新增 BMI 中间产物每个模块接口都要先生成二进制模块接口Binary Module Interface文件构建系统必须自动管理这些产物模块发现与解析构建系统要从源码中提取import语句找到对应的模块接口文件。这意味着构建系统必须看懂源码中的模块语义而不仅仅是机械地处理#include。这正是 build2 投入大量精力解决的问题。build2 的 C20 模块支持从 0.6 到现在的完整演进 build2 早在 0.6.0 版本就开始支持 C Modules TS并在此后每个版本持续增强。其模块编译的核心逻辑位于 compile-rule.cxx而完整的模块测试用例可以在 modules.testscript 中找到。build2 采用了一套完整的目标类型体系来支撑模块构建新手只需记住几个关键类型mxx{}模块接口源文件.mxx如export module foo.core;bmi{}模块接口编译产物BMI由编译mxx{}生成cxx{}普通实现文件通过import消费模块。一键开启模块支持cxx.std 与 cxx.features.modules ⚙️在 build2 中启用 C20 模块非常简单只需在项目根目录的 buildfile 中设置标准版本cxx.std 20 # 启用 C20 标准与模块支持只要cxx.std大于等于 20包括latest、experimental模块支持就会自动开启。如果你需要显式查询或控制模块是否启用可以使用cxx.features.modules布尔变量。对于使用老版本编译器的场景experimental值会启用编译器的模块 TS 支持方便逐步迁移。构建第一个命名模块项目最简示例 来看一个最小可运行的模块项目。首先创建模块接口文件core.mxxexport module foo.core; export int f (int);再创建实现文件core.cxxmodule foo.core; int f (int i) { return i - 1; }然后在 buildfile 中声明目标exe{test}: cxx{driver} {bmi cxx}{core} bmi{core}: mxx{core}最后在主程序driver.cxx中导入模块import foo.core; int main (int argc, char*[]) { return f (argc); }执行b testbuild2 会自动完成先编译模块接口 → 生成 BMI → 再编译导入方 → 链接的完整流程无需你手动排序。模块分区Module Partitions也能轻松搞定 大型项目通常会把一个模块拆分为多个分区partition例如接口分区与实现分区。build2 完整支持模块分区包括接口分区interface partition unit实现分区implementation partition unit分区之间的再导出re-export。得益于 build2 对模块语义的深度解析这些复杂场景与普通模块一样只需在 buildfile 中声明对应的mxx{}源文件即可依赖排序和 BMI 复用全部自动完成。标准库模块std 与 std.compat 自动构建 ️这是 build2 最让人省心的特性之一。传统上要使用标准库模块需要手动为 libc 或 MSVC 标准库构建std模块过程繁琐且容易出错。在 build2 中你只需要import std;build2 会自动完成标准库模块的发现与构建Clang 18自动从 libc 构建std与std.compat标准库模块MSVC同样支持自动构建标准库模块搭配 17.10 混用头文件与模块时体验更佳GCC通过-fprint-file-name自动定位合适的.module.json文件完成模块发现。这套能力定义在 common.hxx 的std_modules配置中你无需关心底层细节。头文件单元与 include translation平滑迁移旧代码 现有的 C 代码库充满了传统头文件。build2 支持两种平滑迁移路径头文件单元Header Units可以直接import vector这类头文件单元build2 会自动生成对应的 BMIinclude translation将#include自动转换为import让老代码逐步模块化。这两项能力在 GCC通过 module mapper和 Clang 中都得到支持测试覆盖可见 headers.testscript。在库中使用模块消费模块化依赖 模块不仅能用于可执行程序也能用于库项目这正是大型工程最需要的模块接口专用库只包含模块接口的库build2 原生支持安装后消费通过 pkg-config 文件传递模块信息其他项目安装后即可直接import无需源码参与。也就是说你可以构建一个纯模块接口的库并安装它下游项目无需看到任何头文件或模块源码直接用import即可这是传统头文件时代无法想象的。三大编译器支持情况一览表 编译器命名模块模块分区头文件单元标准库模块自动构建GCC 11✅✅✅✅module mapperClang 18✅✅✅✅libcMSVC✅✅✅✅std/std.compat常见问题与注意事项 编译器版本模块支持在 GCC 中仍标记为实验性建议使用较新版本以获得完整支持混用头文件与模块MSVC 下同时import std和包含标准库头文件时建议使用 17.10 或更高版本GCC 自动生成头受 module mapper 限制自动生成的头文件在 GCC 下支持尚不完善变更检测build2 对模块导入关系的变化有精确的增量重编译机制改一处模块不会导致全量重编。总结让 C20 模块变得真正可用 ✨C20 模块虽好但离开了强大构建系统的支撑模块地狱会让开发者苦不堪言。build2通过深度集成 GCC、Clang、MSVC 三大编译器自动管理 BMI 生成、依赖排序、标准库模块构建让开发者可以专注于模块本身的设计而不是构建细节。无论你是新建模块化项目还是想逐步迁移现有代码库build2 都是当前 C20 模块构建的可靠之选。【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/8/20 17:59:56 · 阅读 1.2k build2 与 C++20 模块：现代 C++ 模块构建的完整指南
build2 与 C20 模块现代 C 模块构建的完整指南【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2C20 模块Modules是近年来 C 语言最大的变革之一但它给构建系统带来了前所未有的挑战模块需要按依赖顺序编译、要生成二进制模块接口BMI、还要处理标准库模块与头文件单元。build2正是为应对这些挑战而生的现代 C 构建系统。本文将带你快速掌握用 build2 构建 C20 模块项目的完整流程从基础概念到编译器支持差异一次讲清。为什么 C20 模块会让传统构建系统头疼传统头文件 预处理器的编译模型构建系统只需按文件依赖编译即可。而 C20 模块引入了全新的编译模型模块必须按依赖顺序编译被导入的模块必须先编译完成否则无法编译导入方新增 BMI 中间产物每个模块接口都要先生成二进制模块接口Binary Module Interface文件构建系统必须自动管理这些产物模块发现与解析构建系统要从源码中提取import语句找到对应的模块接口文件。这意味着构建系统必须看懂源码中的模块语义而不仅仅是机械地处理#include。这正是 build2 投入大量精力解决的问题。build2 的 C20 模块支持从 0.6 到现在的完整演进 build2 早在 0.6.0 版本就开始支持 C Modules TS并在此后每个版本持续增强。其模块编译的核心逻辑位于 compile-rule.cxx而完整的模块测试用例可以在 modules.testscript 中找到。build2 采用了一套完整的目标类型体系来支撑模块构建新手只需记住几个关键类型mxx{}模块接口源文件.mxx如export module foo.core;bmi{}模块接口编译产物BMI由编译mxx{}生成cxx{}普通实现文件通过import消费模块。一键开启模块支持cxx.std 与 cxx.features.modules ⚙️在 build2 中启用 C20 模块非常简单只需在项目根目录的 buildfile 中设置标准版本cxx.std 20 # 启用 C20 标准与模块支持只要cxx.std大于等于 20包括latest、experimental模块支持就会自动开启。如果你需要显式查询或控制模块是否启用可以使用cxx.features.modules布尔变量。对于使用老版本编译器的场景experimental值会启用编译器的模块 TS 支持方便逐步迁移。构建第一个命名模块项目最简示例 来看一个最小可运行的模块项目。首先创建模块接口文件core.mxxexport module foo.core; export int f (int);再创建实现文件core.cxxmodule foo.core; int f (int i) { return i - 1; }然后在 buildfile 中声明目标exe{test}: cxx{driver} {bmi cxx}{core} bmi{core}: mxx{core}最后在主程序driver.cxx中导入模块import foo.core; int main (int argc, char*[]) { return f (argc); }执行b testbuild2 会自动完成先编译模块接口 → 生成 BMI → 再编译导入方 → 链接的完整流程无需你手动排序。模块分区Module Partitions也能轻松搞定 大型项目通常会把一个模块拆分为多个分区partition例如接口分区与实现分区。build2 完整支持模块分区包括接口分区interface partition unit实现分区implementation partition unit分区之间的再导出re-export。得益于 build2 对模块语义的深度解析这些复杂场景与普通模块一样只需在 buildfile 中声明对应的mxx{}源文件即可依赖排序和 BMI 复用全部自动完成。标准库模块std 与 std.compat 自动构建 ️这是 build2 最让人省心的特性之一。传统上要使用标准库模块需要手动为 libc 或 MSVC 标准库构建std模块过程繁琐且容易出错。在 build2 中你只需要import std;build2 会自动完成标准库模块的发现与构建Clang 18自动从 libc 构建std与std.compat标准库模块MSVC同样支持自动构建标准库模块搭配 17.10 混用头文件与模块时体验更佳GCC通过-fprint-file-name自动定位合适的.module.json文件完成模块发现。这套能力定义在 common.hxx 的std_modules配置中你无需关心底层细节。头文件单元与 include translation平滑迁移旧代码 现有的 C 代码库充满了传统头文件。build2 支持两种平滑迁移路径头文件单元Header Units可以直接import vector这类头文件单元build2 会自动生成对应的 BMIinclude translation将#include自动转换为import让老代码逐步模块化。这两项能力在 GCC通过 module mapper和 Clang 中都得到支持测试覆盖可见 headers.testscript。在库中使用模块消费模块化依赖 模块不仅能用于可执行程序也能用于库项目这正是大型工程最需要的模块接口专用库只包含模块接口的库build2 原生支持安装后消费通过 pkg-config 文件传递模块信息其他项目安装后即可直接import无需源码参与。也就是说你可以构建一个纯模块接口的库并安装它下游项目无需看到任何头文件或模块源码直接用import即可这是传统头文件时代无法想象的。三大编译器支持情况一览表 编译器命名模块模块分区头文件单元标准库模块自动构建GCC 11✅✅✅✅module mapperClang 18✅✅✅✅libcMSVC✅✅✅✅std/std.compat常见问题与注意事项 编译器版本模块支持在 GCC 中仍标记为实验性建议使用较新版本以获得完整支持混用头文件与模块MSVC 下同时import std和包含标准库头文件时建议使用 17.10 或更高版本GCC 自动生成头受 module mapper 限制自动生成的头文件在 GCC 下支持尚不完善变更检测build2 对模块导入关系的变化有精确的增量重编译机制改一处模块不会导致全量重编。总结让 C20 模块变得真正可用 ✨C20 模块虽好但离开了强大构建系统的支撑模块地狱会让开发者苦不堪言。build2通过深度集成 GCC、Clang、MSVC 三大编译器自动管理 BMI 生成、依赖排序、标准库模块构建让开发者可以专注于模块本身的设计而不是构建细节。无论你是新建模块化项目还是想逐步迁移现有代码库build2 都是当前 C20 模块构建的可靠之选。【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考