如何基于C++库生成不含#include的全内联单份.cpp源码文件

手动操作步骤 #

• 第一步：梳理全库拓扑依赖顺序，按照「无任何内部依赖的头文件→仅依赖前者的头文件→所有.cpp实现文件」的顺序排列，避免出现类型未定义、声明顺序错误的问题。
• 第二步：删除所有头文件的守卫代码，也就是#ifndef XXX_H、#define XXX_H、#endif这三段，单文件场景下不需要重复引入防护，留着反而会导致部分代码被意外屏蔽。
• 第三步：给所有非模板、非静态的函数、类方法添加inline标记，原本写在.cpp里的实现直接跟在对应声明后面即可，模板实现不需要额外加inline，本身就符合单定义规则。
• 第四步：把所有引用项目内部头文件的#include "xxx.h"指令，直接替换成对应头文件的完整内容，按之前排好的顺序依次拼接。
• 第五步：如果需要完全移除所有#include（包括标准库引用），可以直接调用编译器预展开功能：
  • GCC/Clang 环境执行：gcc -E -P 你的库入口文件 > 预展开输出.cpp
  • MSVC 环境执行：cl /EP 你的库入口文件 > 预展开输出.cpp
    其中-P和/EP参数会过滤掉预处理器生成的行号、注释标记，直接输出纯展开后的代码内容，输出后手动删掉残留的所有#include指令即可。

自动化工具方案 #

不需要手动处理的话，可以直接用通用的C++单文件合并脚本，比如常用的amalgamate.py，只要指定库的根目录、入口文件、输出路径，脚本会自动完成依赖排序、头文件展开、守卫删除的操作，参考命令：
python amalgamate.py -s ./库源码根目录 -o ./output/single_file.cpp -e ./库入口.h

生成完成后务必做编译校验，部分用到静态全局变量、匿名命名空间的库需要额外调整：把静态全局变量改成C++17及以上支持的inline变量，匿名命名空间的内容按需调整作用域，避免出现ODR（单定义规则）冲突。

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