Linux下CMake构建C++20静态库时<string>头文件编译失败

问题根源 #

编译错误出现在GCC标准库文件中，本质是你的代码中存在与标准库内部标识符冲突的宏定义。标准库（如c++locale.h、ostream_insert.h）使用了__out、__size这类带双下划线的内部变量名，而你的buildsystem.h头文件中可能定义了同名宏，预编译阶段会把标准库代码里的这些标识符替换，导致语法错误。

验证方法 #

临时注释掉output.h中的#include "../buildsystem.h"，重新编译代码：

// #include "../buildsystem.h"  // 临时注释这一行
#include <string>
#include <cstdint>

如果编译通过，即可确认是buildsystem.h引发的冲突。

具体解决方案 #

1. 检查并修改冲突宏
   打开buildsystem.h，查找是否存在以下类型的宏定义：

   • 直接定义__out、__size这类双下划线开头的宏
   • 定义out、size等可能被扩展到标准库代码的宏
     将这些冲突宏重命名为项目专属前缀的名称，比如把__out改为SE_OUT，size改为SE_SIZE，避免与标准库冲突。

2. 临时取消冲突宏（应急方案）
   如果无法修改buildsystem.h（比如是第三方头文件），可以在包含它之后立即用#undef取消冲突宏：

   #include "../buildsystem.h"
   #undef __out
   #undef __size
   // 其他可能冲突的宏也一并取消
   #include <string>
   #include <cstdint>
   

3. 遵守C++标识符规范
   C++标准规定：双下划线开头的标识符、以下划线加大写字母开头的标识符是保留给标准库实现使用的，用户代码绝对不能使用这类标识符，否则必然会引发类似冲突。检查项目中所有自定义宏和变量名，确保符合规范。

补充说明 #

Windows下MSBuild能正常编译，是因为MSVC的标准库内部标识符命名规则与GCC不同，没有触发冲突，但这属于平台侥幸，并非代码本身没有问题。

内容的提问来源于stack exchange，提问作者Ma_rv