为何C++头文件使用.hpp后缀不具备可移植性？会有哪些问题？

《Writing R Extensions》1.1.5节脚注18明确说明：「使用.hpp后缀无法保证可移植性」

表述的具体含义 #

这个表述是针对R扩展的跨平台构建规则提出的：R官方维护的跨平台构建工具链（包括R CMD INSTALL、CRAN的包检查系统）需要兼容大量不同年代、不同架构的操作系统环境，部分老旧Unix类系统、自定义编译的R环境中，R的构建脚本默认只会识别.h作为C/C++头文件的合法后缀，不会将.hpp后缀的文件纳入头文件处理流程，因此直接用.hpp的R扩展无法保证在所有兼容R的环境中都能正常编译安装。

使用错误后缀可能出现的异常问题 #

• 本地编译正常，跨平台安装失败：你自己的开发环境（如新版Windows、macOS、主流Linux发行版）的编译器默认支持.hpp后缀，本地测试可以正常编译，但其他用户安装、或者提交CRAN检查的时候会直接报头文件找不到的错误
• 增量编译异常：R的构建工具不会检测.hpp文件的修改，你修改了对应头文件后重新编译扩展，关联的.cpp源文件不会自动重新编译，会出现运行时逻辑和代码不一致的隐性问题
• 头文件依赖导出失败：如果你的扩展要给其他R扩展提供头文件接口，.hpp后缀的头文件不会被R的install.packages逻辑正确安装到对应目录，其他依赖你的扩展的包会找不到头文件

适用场景说明 #

这个限制仅针对R扩展开发场景，是R生态的特殊规范要求，不适用于绝大多数通用C开发场景：
目前主流的C构建工具链（包括GCC、Clang、MSVC、CMake、Meson等）都原生支持.hpp后缀，通用C项目中使用.hpp区分C头文件和C头文件反而是行业通用的最佳实践，不存在可移植性问题。
只有当你需要开发提交CRAN的R扩展、或者需要兼容上古Unix系统的老旧构建工具时，才需要遵守「C++头文件用.h后缀」的要求。

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