build2 模块体系全解析：config、test、install、version 核心模块指南

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 模块初始化源码 了解它的完整实现逻辑。

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.*）覆盖。

标准安装位置速查

最简安装三步走

$ 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 模块体系的价值在于模块间的无缝协作：

1. config模块先完成环境配置，把编译器、路径、特性开关固化下来
2. version模块从 manifest 读出版本，注入到编译宏和安装路径
3. test模块在构建完成后执行测试，保证产物正确
4. 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