Linux不同路径stddef.h差异及C++开发头文件选型问题

Linux内核头文件从设计上就分为两类面向不同场景的版本，路径差异就是定位不同的直接体现：

• 路径带uapi的是用户空间API（User-space API）专用头文件，是内核专门对外暴露给用户空间程序使用的头文件集合，内容严格和用户空间ABI兼容，仅包含对外公开的通用定义，不会涉及内核私有逻辑。
• 路径在include/linux/下的是内核内部编译专用头文件，仅供给Linux内核本身、内核模块编译时使用，会包含大量内核私有的编译宏、内部接口定义，对外不保证兼容性。

你提供的两份文件内容存在标注错误：实际include/linux/stddef.h会先引入uapi/linux/stddef.h的基础定义，再叠加内核专属的扩展（比如你贴的__always_inline就是内核编译专用的属性宏），这就是二者内容差异的核心原因：内核内部版本是在对外暴露的uapi版本基础上，补充了内核场景独有的私有定义。

常规用户空间C应用开发，这两个内核头文件都不建议主动选用：
C标准规定的stddef.h（对应C风格的<cstddef>）由编译器（GCC/Clang等）或系统C标准库（glibc）提供，其中NULL、offsetof、size_t等定义完全符合C标准规范，没有兼容性问题，是正常开发的首选。

只有当你的C应用需要调用Linux内核专属特殊接口、必须依赖内核层面的特定定义时，才可以选用uapi目录下的stddef.h，同时需要注意兼容性坑：比如内核定义的NULL为(void *)0，而C标准不允许void*指针隐式转换为其他类型指针，直接使用可能触发编译错误，需要自行做适配处理。

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