C++仅头文件代码编译耗时更长 能否带来更快的运行速度？

两种方案优缺点对比 #

仅头文件实现（全.h方案） #

优点

• 无需额外编译链接配置，引入头文件即可直接使用，适配C++模板类的实现要求（模板实例化时需要可见完整定义，天然适合头文件实现）
• 只要保证头文件符合ODR（单一定义规则），无需处理链接阶段的符号冲突问题
• 编译器可获得完整的函数、类实现上下文，优化空间更大

缺点

• 修改头文件后，所有引入该头文件的编译单元都要重新编译，项目规模大的话编译耗时会大幅上升
• 头文件中引入的依赖会传递给所有引入者，间接增大编译单元体积，进一步拖慢编译速度
• 代码实现直接暴露，不适合需要闭源交付的商用库
• 容易出现重复定义冲突，如果头文件没有加正确的#pragma once或者#ifndef头文件保护，多编译单元引入时会直接报错

拆分.h声明与.cpp实现方案 #

优点

• 编译增量性好，修改.cpp实现文件时，只需要重新编译该单个编译单元，无需重编依赖头文件的其他代码，大项目下编译效率提升非常明显
• 头文件仅保留对外接口声明，隐藏内部实现细节，既降低了对外的依赖传递，也适合闭源交付（只需要给头文件+编译好的静态/动态库即可）
• 有效减少多编译单元的重复符号问题，只要声明不重复，实现仅在单个编译单元存在，不会出现冲突

缺点

• 模板类等需要完整定义可见的场景无法直接使用该方案，需要额外做显式实例化处理，开发成本更高
• 跨编译单元的函数调用默认无法内联，除非开启LTO（链接时优化），否则优化空间受限
• 需要处理链接阶段的符号匹配问题，比如实现和声明不匹配、漏加导出标记等问题都要到链接阶段才能发现，排错成本更高

仅头文件实现是否会生成运行速度更快的代码？ #

在不开启LTO的前提下，大部分场景下仅头文件实现的代码运行速度确实会更快，核心原因是：

• 编译器可以在编译单个编译单元时直接看到所有函数的实现，自动做内联、常量折叠、死代码消除等优化，不需要依赖链接阶段的跨单元优化
• 可以避免跨编译单元函数调用的开销，尤其是小函数、高频调用的函数，内联后的性能收益非常明显

注意：如果开启了LTO（链接时优化），编译器会在链接阶段合并所有编译单元的中间表示，此时两种方案的优化空间几乎没有差异，最终生成的二进制运行速度基本一致

实际开发中一般会根据场景混合使用两种方案：比如小型工具库、高频调用的核心工具函数用头文件实现，业务逻辑代码用拆分的方案，兼顾编译效率和运行性能。

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