定义单个C++函数是否必须同时创建对应的.h与.cpp文件？

核心结论 #

不是所有函数都必须同时创建对应的.h和.cpp文件，你给出的模板函数拆分写法反而是错误的，会引发链接错误。

不同函数类型的组织规则 #

1. 普通非模板、非内联函数 #

这类函数推荐按「声明放.h，实现放.cpp」的规则拆分，优势如下：

• 减少编译依赖：修改函数实现时，仅需要重新编译对应的.cpp文件，不需要重新编译所有引用了头文件的代码文件
• 隐藏实现细节：对外仅暴露头文件中的声明即可

2. 模板函数（包括你提到的InsertionSort模板函数） #

C++模板在实例化时必须可见完整的实现代码，如果你把模板实现放在单独的.cpp文件中，其他代码仅引入头文件的情况下，编译器无法生成对应类型的模板实例，链接阶段会直接报undefined reference错误。
针对模板函数有两种可行的组织方式：

• 推荐方案：直接把模板的声明+实现全部放在对应的.h文件中，完全不需要创建对应的.cpp文件，刚好适配你目前每个函数单独存放在.h文件的组织习惯
• 可选方案（仅适合固定实例化场景）：如果坚持拆分，需要在.cpp文件末尾手动添加所有需要用到的模板类型的显式实例化代码，示例如下：

// InsertionSort.cpp末尾添加
template void InsertionSort<int>(int A[], short n);
template void InsertionSort<double>(double A[], short n);
// 其他需要用到的类型依次添加

这种方式局限性很强，无法支持后续使用未提前声明的类型，不推荐使用。

3. 内联函数 #

和模板函数规则一致，完整实现必须对编译器可见，因此直接全部放在.h文件中即可，不需要单独的.cpp文件。

针对你当前场景的建议 #

你目前已经是每个函数单独存放一个.h文件的组织方式，可以按类型分类处理：

• 普通非模板小函数直接加inline关键字放在.h中，不需要额外建.cpp
• 逻辑复杂的普通非模板函数，可以按需拆分出对应的.cpp文件存放实现
• 所有模板函数不需要做任何改动，直接全部放在.h中即可

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