类外独立函数的文件分离：头文件与源文件该如何选择？

嘿，这个问题问到点子上了——很多刚从类的分离写法过渡的开发者都会卡在这，其实类外的通用工具函数，处理逻辑和类的分离思路本质是相通的，只是细节上有区别，我给你理得明明白白：

和类的分离逻辑一致，普通的类外复用函数，也应该把声明和实现分开存放：

1. 头文件（.h）放函数声明
   在这里只告诉编译器“有这么一个函数，它的参数、返回值是什么样的”，同时一定要加上头文件保护，防止重复包含导致的编译错误：

   // utils.h
   #ifndef UTILS_H
   #define UTILS_H
   
   #include <string>
   // 声明一个通用的字符串修剪函数
   std::string trim(const std::string& str);
   
   #endif // UTILS_H
   

2. 源文件（.cpp）放函数实现
   在这里写函数的具体逻辑，同时要包含对应的头文件：

   // utils.cpp
   #include "utils.h"
   #include <algorithm>
   #include <cctype>
   
   std::string trim(const std::string& str) {
       auto start = str.begin();
       while (start != str.end() && std::isspace(static_cast<unsigned char>(*start))) {
           start++;
       }
       auto end = str.end();
       do {
           end--;
       } while (std::distance(start, end) > 0 && std::isspace(static_cast<unsigned char>(*end)));
       return std::string(start, end + 1);
   }
   

直接把函数实现写在头文件里会踩几个坑：

• 重复定义错误：如果多个 .cpp 文件都包含这个头文件，链接阶段会触发ODR（One Definition Rule，单定义规则）错误——同一个函数被多次定义了。
• 编译效率低下：每次修改函数实现，所有包含这个头文件的源文件都要重新编译，大型项目里这会拖慢编译速度。
• 封装性差：没必要把函数的内部实现暴露给所有调用者，既增加了阅读负担，也容易不小心修改到实现细节。

有些特殊函数必须（或适合）把实现写在头文件里，比如：

• 模板函数：模板需要在编译时针对具体类型实例化，编译器必须能看到完整的实现代码，所以通常直接放在头文件里。
• inline 函数：用 inline 关键字修饰的函数，编译器会尝试将其展开到调用处，避免函数调用开销。这类函数可以放在头文件里，只要保证所有编译单元中的定义完全一致即可：

  // utils.h
  inline int add(int a, int b) {
      return a + b;
  }
  

• constexpr 函数：C++11及以后的常量表达式函数，需要编译器在编译时计算结果，因此也适合放在头文件里。

绝大多数普通的类外复用函数，都遵循**声明放 .h，实现放 .cpp**的规则，再配合头文件保护；只有模板、inline、constexpr这类特殊函数，才适合把实现直接写在 .h 中。这种做法既保证了函数的复用性，又能避免编译链接问题，还能提升项目的编译效率。

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