1 / 4概念
Toolchain: Compilers and Standards
同一份源码在 gcc、clang 与 msvc 上都能编译通过,不代表三个产物能互相链接。编译器同时决定四件事:语言特性集合、标准库实现、名字修饰与运行时约定。把这四件事分开看,跨平台构建才有落点。
1 概念
1.1 一句话定义
C++ 编译器是一条四段流水线:预处理器展开头文件与宏,前端做语义分析并生成中间表示,中端优化,后端生成目标文件;链接器再把目标文件、标准库与启动代码合成可执行文件或共享库。-std 选择语言与库特性集合,ABI 开关选择二进制契约,两者都不在源码里。
1.2 它解决什么问题
- 特性对齐:使用
std::span、concepts或std::expected之前,应确认三个平台的标准库都已提供。 - 产物契约:预编译头、模块接口单元与目标文件都绑定编译器版本,升级编译器必须重编全量产物。
- ABI 绑定:
_GLIBCXX_USE_CXX11_ABI、_ITERATOR_DEBUG_LEVEL与/MD、/MT改变符号或布局,混用即链接失败或运行期崩溃。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 对象布局、vtable 与名字修饰规则 | Runtime: Object Model and ABI(cpp-object-model-and-abi) |
异常展开、terminate 路径与 noexcept | Runtime: Exception Unwinding(cpp-exception-runtime) |
| 模板实例化、ODR 与显式实例化 | Feature: Templates(cpp-templates) |
| 构建目标、生成器与安装导出 | Toolchain: CMake(cpp-cmake) |
| 测试、sanitizer 与调试器 | Toolchain: Test and Debug(cpp-testing-and-debugging) |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| translation unit | 一个源文件加上它包含的全部头文件,预处理后的结果 | 不是链接后的程序,也不是单个目标文件 |
| driver | 用户调用的 g++、clang++、cl,负责调度预处理到链接 | 不是 cc1plus 这类实际编译器进程 |
-std= | 选择语言标准级别,同时放开对应的库设施 | 不保证标准库已实现全部设施 |
| feature-test macro | __cpp_lib_span 一类宏,声明特性可用 | 比 -std 更可信的判据 |
| PCH 与 BMI | 预编译头缓存解析结果,模块接口单元产出 BMI | 两种产物不通用,都绑定编译器版本与选项 |
| name mangling | 把函数签名编码进符号名 | 不同编译器、不同版本可能不同 |
| dual ABI | libstdc++ 的两套 std::string 实现 | 由宏选择,不由标准选择 |
_ITERATOR_DEBUG_LEVEL | MSVC 的迭代器调试级别,写入目标文件 | 与 /MD、/MT 一起参与链接校验 |
2 机制
2.1 心智模型
把一次构建想成四份契约的签署。源码到 TU:#include 是文本包含,宏与 #if 在此时定型。TU 到目标文件:语言标准、优化等级与 ABI 开关在这里落地。目标文件到库:名字修饰、可见性与链接器选项决定谁找得到谁。库到库:标准库版本、CRT 副本、异常与 RTTI 约定决定同一进程能否共存。每份契约都由命令行决定,且不写进源码;两份契约不一致时,症状出现在离原因最远的那一步。
2.2 机制拆解
- driver 与阶段:
-c只到目标文件,-E停在预处理,-S停在汇编;--target与-m32改变目标 triple;-v打印真实子命令与搜索路径。 - 标准与库分离:
-std=c++20只提升语言与头文件的可见性;std::format是否可用取决于标准库版本,应用__cpp_lib_format判定。 - 头文件、PCH、头文件单元与模块:
#include每次重新解析;PCH 缓存解析结果但不改变可见性;头文件单元把import <vector>;变成可缓存的导入;命名模块把接口编译成 BMI,按模块名解析。 - dual ABI:GCC 5 起
std::string与std::list有两套实现,由_GLIBCXX_USE_CXX11_ABI选择;ABI=1 时符号落在std::__cxx11命名空间,ABI=0 时是旧布局。 - MSVC 的隐性开关:
_ITERATOR_DEBUG_LEVEL、_MT与RuntimeLibrary都写进目标文件,链接器逐项比对,不一致直接LNK2038。 - 异常、RTTI 与 LTO:
-fno-exceptions去掉展开表并禁用throw,-fno-rtti去掉 typeinfo;-flto让目标文件变成编译器插件的字节码,三者都不跨编译器版本。
2.3 完整枚举
C++11 起的标准级别与三种编译器的开关一一对应(C++98 与 C++03 只有 gcc 与 clang 接受,新项目不应选择);__cplusplus 是跨平台判据,但 msvc 需要额外开关才输出真值。
| 标准 | __cplusplus | gcc 与 clang | msvc | 实际可用性 |
|---|---|---|---|---|
| C++11 | 201103L | -std=c++11 | 无对应开关,最低为 /std:c++14 | gcc 4.8+、clang 3.3+、VS 2015+ |
| C++14 | 201402L | -std=c++14 | /std:c++14 | gcc 5+、clang 3.5+、VS 2015+ |
| C++17 | 201703L | -std=c++17 | /std:c++17 | gcc 7+、clang 5+、VS 2017 15.7+ |
| C++20 | 202002L | -std=c++20 | /std:c++20 | gcc 10+ 主体、clang 13+、VS 2019 16.11+ |
| C++23 | 202302L | -std=c++23 | /std:c++latest | gcc 13+、clang 17+,库支持滞后于语言 |
| C++26 | 未定稿 | -std=c++26,clang 亦接受 -std=c++2c | /std:c++latest | 仅实验,逐特性用宏判定 |
msvc 的 __cplusplus 默认是 199711L,必须加 /Zc:__cplusplus 才报告真实值;判断标准应改用 _MSVC_LANG。gnu++17 一类写法是同一标准的 GNU 扩展变体,-std=c++17 才是严格模式;C++20 模式下 msvc 隐式开启 /permissive-,依赖旧式两阶段查找的代码会在这里第一次报错。平台模型也不同:Windows 是 LLP64、long 4 字节、wchar_t 2 字节,Linux 与 macOS 是 LP64、long 8 字节、wchar_t 4 字节。
2.4 ABI 与语义开关
这些开关不改语法,改的是二进制契约;它们不出现在源码里,却决定链接成败。
| 开关 | 编译器 | 影响 | 混用的症状 |
|---|---|---|---|
_GLIBCXX_USE_CXX11_ABI | gcc、libstdc++ | std::string、std::list 的布局与符号 | undefined reference to tag[abi:cxx11]() |
_ITERATOR_DEBUG_LEVEL | msvc | 容器迭代器布局与调试检查 | LNK2038 报该宏的两个值 |
/MD 与 /MT | msvc | CRT 副本与堆归属 | LNK2038: RuntimeLibrary mismatch,跨 CRT 释放崩溃 |
-fno-exceptions | gcc、clang | 去掉展开表,禁用 throw | 展开路径上的 throw 触发 terminate |
-fno-rtti | gcc、clang | 去掉 typeinfo 与 dynamic_cast | typeinfo 符号未定义,或 dynamic_cast 编译失败 |
-flto | 三者 | 跨 TU 优化的字节码形式 | 与不同版本的 LTO 目标混链,插件报错或静默错码 |
3 实践
3.1 最小示例
先用一个探测程序把“标准、库、平台”三条信息一次打出来:
// probe.cpp
#include <cstdio>
#include <version>
int main() {
std::printf("cplusplus=%ld long=%zu wchar=%zu\n",
__cplusplus, sizeof(long), sizeof(wchar_t));
#ifdef __cpp_lib_span
std::printf("span=%ld\n", static_cast<long>(__cpp_lib_span));
#endif
}
g++ -std=c++20 -O2 -Wall -Wextra -Wpedantic probe.cpp -o probe && ./probe
cl /std:c++20 /Zc:__cplusplus /EHsc probe.cpp
在 x86_64 Linux 上输出 cplusplus=202002L long=8 wchar=4;同一份源码在 msvc 上得到 long=4 wchar=2,去掉 /Zc:__cplusplus 则退回 199711L。span= 这一行是否出现由标准库版本决定,与 -std 无关,这正是标准级别与库实现必须分开看的原因。
ABI 混用的最小复现只需两次编译加一次链接:g++ -c -D_GLIBCXX_USE_CXX11_ABI=0 lib.cpp 与 ...=1 main.cpp 各自成功,链接时报 undefined reference to tag[abi:cxx11]()。原因是 tag() 在 ABI=0 下修饰为 _Z3tagv,在 ABI=1 下修饰为 _Z3tagB5cxx11v;链接器只按名字匹配,因此它报“找不到符号”,而不是“ABI 不一致”。nm -C 对两个目标文件各跑一次,两行输出并排即是证据。
3.2 常用命令
| 目的 | 命令 | 说明 |
|---|---|---|
| 只编译不链接 | g++ -std=c++20 -c a.cpp | 产出 a.o,便于检查单个 TU |
| 查看真实子命令 | g++ -v -c a.cpp | 打印 include 搜索路径与 cc1plus 参数 |
| 查看目标 triple | clang++ -print-target-triple | 交叉编译时确认目标 |
| 查符号与 ABI 标记 | nm -C a.o | 直接暴露修饰后的名字 |
| 生成并使用 PCH | clang++ -std=c++20 -x c++-header pch.hpp -o pch.pch | 使用侧加 -include-pch pch.pch |
| 编译模块接口 | g++ -std=c++20 -fmodules-ts -c mod.cppm | 产物落在 gcm.cache |
3.3 标准流程
- 先定最低标准级别,再用探测程序在三个平台各跑一次,确认
__cplusplus与关键__cpp_lib_*宏;ABI 宏写进构建系统的公共配置,禁止按文件临时加-D。 - 预编译头只放稳定、庞大的系统头;业务头不进 PCH,否则每次改动都触发全量重编。
- 模块化从新子系统开始,接口单元只导出声明;已有头文件库保持
#include,不要半途混用。 - 每次升级编译器,先重编第三方依赖,再重编本仓库,最后跑 ABI 符号比对;CI 保留一个“最旧编译器”组合。
3.4 选型矩阵
| 场景 | 编译器与标准 | 代价 |
|---|---|---|
| 跨三平台发布的库 | 三编译器 + 最低公共标准 C++17 | 放弃 concepts、std::span 等设施 |
| 单一 Linux 服务 | 发行版 gcc 或最新 clang + C++20 | 升级工具链后必须重编全部动态依赖 |
| 追求诊断与工具链体验 | clang + libc++ + clang-tidy | 第三方预编译库多为 libstdc++,需自行重编 |
| Windows 桌面与游戏 | msvc + /std:c++20 + /permissive- | 与 MinGW 产物不可混链,CI 需 Windows 机器 |
| 嵌入式与交叉编译 | 厂商 gcc + -fno-exceptions -fno-rtti | 标准库需裁剪,所有依赖必须同开关重编 |
3.5 决策规则
- 标准级别应写进构建配置并由
target_compile_features传播,不应依赖编译器默认值。 - 特性可用性应用
__cpp_lib_*判定,不用-std或编译器版本号推断。 - ABI 宏应全仓库统一,一个进程内只允许一份标准库、一份 CRT。
-fno-exceptions只在确实需要裁剪代码体积或对齐 C 库时启用,且要求整条依赖链同开关。
4 边界
4.1 典型故障
| 症状 | 根因 | 诊断 | 修复 |
|---|---|---|---|
undefined reference to tag[abi:cxx11]() | _GLIBCXX_USE_CXX11_ABI 两侧不一致 | nm -C 对比两个目标文件的符号 | 全仓库统一 ABI 宏并重编依赖 |
LNK2038: RuntimeLibrary mismatch | 一侧 /MD、另一侧 /MT | 看错误里给出的两个值 | 统一运行库选项,重编静态库 |
LNK2038: _ITERATOR_DEBUG_LEVEL | Debug 与 Release 目标混链 | 检查两侧的配置 | 按配置分别构建与链接 |
模板代码链接期 undefined reference | 定义在 .cpp 内,实例化点看不到 | nm 查符号是否存在 | 定义移入头文件或显式实例化 |
multiple definition of ... | 头文件里定义了非 inline 函数或全局对象 | 链接器报出两个目标文件 | 加 inline,或移入单个 TU |
dynamic_cast 编译失败或 typeinfo 未定义 | 用了 -fno-rtti | 看编译错误与 nm 的 _ZTI 符号 | 开启 RTTI,或改用访问者与标签 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
在单个文件上临时加 -D 改 ABI 宏 | 局部符号与全仓库不一致,链接期才暴露 | 统一放进构建配置的公共接口 |
| 用编译器版本号推断标准库能力 | 发行版的旧标准库缺少新设施 | 用 __cpp_lib_* 与 <version> 判定 |
| 把业务头塞进 PCH | 每次改动触发全量重编,收益为负 | PCH 只放稳定系统头 |
4.3 可观测信号
构建侧看 -Wall -Wextra -Wpedantic 的告警数量、-ftime-trace 里模板与头文件的耗时占比、nm -C 的符号差异。ABI 侧看 LNK2038 的具体字段、std::__cxx11 命名空间是否一致、ldd 是否只链到一份 libstdc++。运行侧看 terminate 的调用栈,以及跨边界对象的析构是否落在创建它的堆上。
4.4 安全 / 性能 / 一致性边界
- 安全:编译器按“没有未定义行为”做优化;
-fno-exceptions与-fno-rtti移除运行期检查,缺陷从编译错误退化为运行期崩溃。 - 性能:PCH 与模块主要省解析时间,不改善运行期;只有
-flto带来跨 TU 内联,代价是链接时间与内存。 - 一致性:标准级别、标准库实现与 ABI 宏必须同时锁定;只锁其中一项,得到一个能编译但不能链接的组合。