引入文件从.cpp改名为.h报"unknown type name 'size_t'"错误的原因及解决方法

问题原因 #

1. size_t 不属于C/C的内置基础类型，是标准库定义的别名类型，它的定义存放于 <stddef.h>（C标准头）、<cstddef>（C标准头）中，也会被 <stdio.h>、<cstdio>、<vector> 等常用标准头间接引入。
2. 文件名后缀不同触发了编译器的差异化处理逻辑：

• 当文件名为 args.cpp 时，交叉编译器会将其识别为C++源文件处理。此前你的args.cpp作为源文件时，开头必然引入了至少一个包含size_t定义的头文件，因此编译时不会报错。
• 重命名为args.h后触发报错的核心原因是头文件未做到自包含：你大概率是把原本args.cpp开头的标准头引入语句移除了，或者将args.h放在了其他源文件的标准头引入语句之前，导致编译器解析到args.h里的size_t时，还没有读到对应的类型定义，因此抛出未知类型错误。

解决方法 #

要正常使用args.h作为文件名，只需要修正头文件的依赖声明即可，操作如下：

• 在args.h的最开头，头文件守卫之后的第一行，显式引入包含size_t定义的标准头：
  • 如果该头文件需要兼容C语言，添加 #include <stddef.h>
  • 如果是纯C++头文件，添加 #include <cstddef>，如果要使用全局命名空间的size_t，可额外添加 using std::size_t;，否则直接使用std::size_t声明即可。
• 给args.h添加标准头文件守卫，避免重复引入导致的编译错误，完整结构参考：

#ifndef ARGS_H
#define ARGS_H

// 按需引入下面其中一行
#include <stddef.h>
// 或 #include <cstddef>

// 此处放置你原本的args.h文件代码

#endif // ARGS_H

• 额外注意：不要直接将.h头文件作为独立编译目标传入编译器，头文件仅需被.c/.cpp源文件引入即可，独立编译单元仍为源文件。

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