build2 配置变量实战指南：如何选择编译器、定制编译选项并持久化保存-开发者社区

build2 配置变量实战指南：如何选择编译器、定制编译选项并持久化保存

【免费下载链接】build2build2 build system项目地址: https://gitcode.com/gh_mirrors/bu/build2

build2 是一个现代化的 C/C++ 构建系统，配置变量（configuration variables）是其最核心的利器。无论你是刚接触 build2 的新手，还是想摆脱重复输入命令的普通用户，掌握config.cxx、config.cxx.coptions等配置变量的用法，就能轻松实现编译器切换、编译选项定制与配置持久化。本文将以最简明的实战方式，带你快速上手 build2 的配置体系。

一、什么是 build2 配置变量？

在 build2 中，一切与"怎么构建"相关的设置都以变量的形式存在，它们的名字统一以config.开头。构建时，你只需把它们作为命令行参数传给b（build2 的构建驱动程序）即可：

$ b config.cxx=clang++

这一行命令的含义是：使用 clang++ 作为 C++ 编译器。build2 默认使用编译自身时所用的编译器，而通过配置变量，你可以随时切换为 GCC、Clang 或 MSVC 的任意版本。

💡核心机制：命令行上的配置变量优先级最高，它会覆盖 buildfile 中的同名设置。这一机制贯穿 build2 配置体系的始终。

二、选择编译器：config.cxx 与 config.c

2.1 指定 C++ 编译器

最常见的需求就是更换编译器，比如从默认的 g++ 切到 clang++：

$ b config.cxx=clang++

在 Windows 上使用 MSVC 时，可以直接指定cl的绝对路径（注意路径含空格需加引号）：

$ b "config.cxx='C:\...\VC\Tools\MSVC\14.23.28105\bin\Hostx64\x64\cl'"

2.2 C 语言编译器自动推导

与config.cxx对应的是config.c（指定 C 编译器）。但有个省心的规则：如果你的项目同时使用 C 和 C++，通常只需指定其中一个，build2 会自动推导另一个，无需手动重复配置。

三、编译选项：coptions、poptions 与 loptions

选好了编译器，接下来就是定制编译选项。build2 把编译选项拆分成三组变量，各司其职：

配置变量	作用	示例值
`config.cxx.poptions`	预处理选项（预处理阶段，如`-I`头文件路径、`-D`宏定义）	`-I/usr/local/include`
`config.cxx.coptions`	编译选项（编译阶段，如`-g`调试信息、`-O2`优化）	`-g`
`config.cxx.loptions`	链接选项（链接阶段，如`-L`库路径）	`-L/usr/local/lib`

以最常见的"开启调试信息"为例：

$ b config.cxx=clang++ config.cxx.coptions=-g

这样一条命令就同时完成了编译器选择和编译选项定制，非常直观。

3.1 对应的 C 与通用版本

同样的变量在 C 和通用层面也存在：

config.c.poptions、config.c.coptions、config.c.loptions：针对 C 语言
config.cc.poptions、config.cc.coptions、config.cc.loptions：C/C++ 通用

链接库还有config.cxx.libs（链接时追加的库）和config.cxx.aoptions（归档选项，用于静态库），它们都会在配置时自动写入持久化文件。

四、持久化配置：configure 与 config.build

每次构建都敲一长串config.cxx=... config.cxx.coptions=...显然很烦人。build2 提供了持久化配置机制，让你配置一次、终身受益。

4.1 一键配置命令

在项目根目录执行configure元操作，即可把配置变量保存下来：

$ b configure config.cxx=clang++ config.cxx.coptions=-g

执行后，项目下会生成一个build/目录，其中最重要的就是build/config.build文件。打开它你会发现，它本质上就是一个普通的 buildfile，内容就是一组变量赋值：

config.cxx = clang++ config.cxx.poptions = [null] config.cxx.coptions = -g config.cxx.loptions = [null] config.cxx.aoptions = [null] config.cxx.libs = [null]

4.2 持久化之后的好处

配置保存后，后续构建完全无需再带任何参数：

$ b # 使用持久化的 clang++ 与 -g $ b clean # 清理 $ b # 再次构建，配置依然生效

这就是持久化配置的威力：一次性输入，反复生效。

五、修改与覆盖配置的最佳实践

配置持久化之后，你仍有三条路径随时调整，按场景选择即可。

5.1 直接编辑 config.build 文件

既然build/config.build只是普通 buildfile，你完全可以打开编辑器手动修改其中的变量值，保存后立即生效。

5.2 重新 configure（保留未指定项）

如果只想修改部分配置，可以重新执行configure，未指定的变量会原样保留。例如把编译器换成 g++，但保留已有的-g选项：

$ b configure config.cxx=g++

执行后config.cxx更新为g++，而config.cxx.coptions = -g保持不变。

5.3 临时覆盖（单次生效）

只想临时测试某个选项、又不想污染持久化配置？直接在命令行覆盖即可，仅对本次构建生效：

$ b config.cxx.coptions=-O3 # 本次用 -O3 重新构建 $ b # 下次仍回到持久化的 -g

5.4 还原变量到默认值

想把某个变量恢复默认？把它加入特殊的config.config.disfigure变量即可：

$ b configure config.config.disfigure=config.cxx

5.5 彻底清除配置

如果想完全移除持久化配置、让项目回到未配置状态，使用disfigure元操作：

$ b disfigure

六、多套配置并行构建的进阶玩法

持久化配置的另一个妙用是多配置并行。利用 out-of-source 构建，你可以在不同目录中为同一份源码建立多套独立配置，互不干扰。例如分别建立调试版与优化版：

$ b hello/@hello-gcc/ config.cxx=g++ $ b hello/@hello-clang/ config.cxx=clang++

每个目录拥有各自的config.build，构建同一份源码却能产出不同的二进制。这在对比编译器行为、验证多版本兼容性时尤为实用。

七、源码探秘：配置变量从哪里来？

如果你对底层实现感兴趣，可以翻阅 build2 源码一探究竟：

config 模块负责注册configure/disfigure元操作、维护变量并加载config.build，核心实现位于 libbuild2/config/init.cxx（configure元操作注册与变量管理）与 libbuild2/config/utility.cxx。
cc 模块负责注册config.cxx、config.cxx.coptions等编译器相关变量，见 libbuild2/cc/init.cxx（配置变量登记与默认值处理）。
官方手册对配置变量的完整说明在 doc/manual.cli 中（搜索config.cxx即可定位）。