build2 模块体系全解析：config、test、install、version 核心模块指南
【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2
对于刚接触build2 构建系统的开发者来说，最让人困惑的往往不是语法本身，而是它那套清晰却略显庞杂的模块体系。build2 并非一个"大而全"的单一程序，而是由config、test、install、version等多个核心模块组合而成的现代化 C/C++ 构建工具链。本篇文章将带你完整梳理 build2 模块体系，用最直白的方式讲清楚每个模块的职责、常用配置与实战用法，帮你快速建立起对这套构建系统的整体认知。
为什么 build2 需要"模块化"架构？
传统构建工具（如 Make）把所有能力揉在一个引擎里，功能多了以后互相纠缠、难以维护。build2 选择了另一条路：按职责拆分成独立模块，每个模块负责一类构建任务，通过统一接口协作。
- config 模块：管理配置与构建环境
- test 模块：运行测试与 testscript 脚本
- install 模块：完成安装与卸载
- version 模块：自动生成与校验项目版本
这套设计让 build2 既能保持核心引擎的轻量，又能按需加载能力。从源码目录libbuild2/下可以清楚看到每个模块都有独立的init.cxx（模块初始化）、operation.cxx（操作实现）和rule.cxx（规则定义），结构一目了然。
config 模块：项目配置管理的基石
config 模块是 build2 模块体系中所有配置的"总开关"，负责把构建配置持久化到build/config.build文件中，并处理命令行上的config.*变量覆盖。
一键配置与持久化机制
当你执行b configure时，config 模块会收集所有config.*变量并保存到build/config.build，下次构建时自动复用。这意味着配置一次、处处生效，无需重复传参。
$ b configure config.cxx=g++-11 config.cxx.std=latest密封构建（Hermetic Build）配置
config 模块最具特色的能力之一是密封构建配置：通过config.config.hermetic=true开启后，构建时影响项目的环境变量（如PATH）会被连同配置一起保存，之后所有操作都在该环境下执行，保证构建结果的可复现性：
$ b configure config.config.hermetic=true常用的 config 模块配置项
| 配置变量 | 作用 |
|---|---|
config.config.hermetic | 是否开启密封构建 |
config.config.environment | 指定参与密封的环境变量列表 |
config.report系列 | 控制变量是否出现在配置报告中 |
感兴趣的话，可以直接阅读 config 模块初始化源码 了解它的完整实现逻辑。
test 模块：让测试运行变得简单
test 模块负责把测试变成构建流程的一等公民。它不仅仅能运行普通可执行文件，还支持一套强大的testscript脚本语言，用来描述复杂的测试场景（如重定向、环境变量、退出码校验等）。
用 config.test 精准筛选测试
当项目测试很多时，用config.test变量可以精准定位要运行的测试目标或脚本：
$ b test config.test=foo/exe{driver} # 只测试指定目标 $ b test config.test=bar/baz # 只运行指定 testscript 用例testscript 让测试"活"起来
在 build2 中，*.test.testscript文件用描述性语言定义测试步骤，而不用写一堆 shell 脚本。项目里大量的lexer+*.test.testscript、parser+*.test.testscript文件就是典型例子——它们把词法、语法解析器的各种边界情况都覆盖到了。
test 模块的核心逻辑在 test 模块初始化源码 中，其中config.test、test.options、test.arguments等变量都从这里注册进变量池。
install 模块：安装与卸载的标准答案
install 模块定义了 build2 的标准安装位置体系，让"把项目装到系统里"这件事有了一套统一约定。它内置了从root到man的十几级安装路径，全部支持通过config.install.*（简写c.i.*）覆盖。
标准安装位置速查
| 安装位置 | 默认路径 | 覆盖变量 |
|---|---|---|
root | /usr/local/ | c.i.root |
bin | root/bin/ | c.i.bin |
lib | root/lib/ | c.i.lib |
include | root/include/ | c.i.include |
share | root/share/ | c.i.share |
man | root/share/man/ | c.i.man |
最简安装三步走
$ b configure --prefix=/opt/mylib # 1. 指定安装前缀 $ b # 2. 构建 $ b install # 3. 安装值得一提的是，install 模块还支持变量替换（如<project>、<version>自动展开），源码实现见 install 模块初始化源码。
version 模块：版本管理的自动化引擎
version 模块是 build2 模块体系中最"聪明"的一个：它读取项目manifest文件中的版本声明，自动派生出一整套标准版本变量（如project.version、project.version.major等），供 buildfile 和安装路径使用。
标准版本格式
build2 推荐遵循语义化版本（SemVer）风格的标准版本格式：
<major>.<minor>.<patch>[-<prerel>]例如1.2.3、1.2.3-a.1。在 C/C++ 语境下，patch 对应二进制兼容改动，minor 对应源码兼容改动，major 对应破坏性改动。
version 模块的自动化魔法
- 从 git 仓库自动计算开发快照版本（如
0.1.0-a.0.20231001），无需手动维护 - 自动生成
version.hxx头文件，把版本号变成代码常量 - 与 dist 模块协作，打包时自动生成带版本号的发布包名
版本模块的数据结构定义在 version 模块头文件 中，可以看到它封装了version、committed、rewritten等关键状态。
四个核心模块如何协同工作？
build2 模块体系的价值在于模块间的无缝协作：
config模块先完成环境配置，把编译器、路径、特性开关固化下来version模块从 manifest 读出版本，注入到编译宏和安装路径test模块在构建完成后执行测试，保证产物正确install模块把通过验证的产物安装到标准位置
整套流程只需几条命令即可串联：
$ b configure $ b test $ b install总结：掌握 build2 模块体系，就是掌握构建全流程
通过本文可以看到，build2 模块体系的精髓在于"各司其职、协同作战"：config管配置、test管验证、install管交付、version管版本。对于新手而言，先理解这四个核心模块的职责与常用变量，就足以驾驭日常的构建、测试与安装工作；想要深入，直接阅读libbuild2/下各模块的源码与官方文档（doc/manual.cli）是不错的选择。
无论你是从零开始学习 build2，还是想从 Make/CMake 迁移过来，理清这套模块体系，都会让后续的学习事半功倍。现在就打开你的项目，试着用b configure、b test、b install跑通一次完整流程吧！
【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
