为什么无法在.hpp文件中定义类静态成员变量，是否必须放在.cpp文件？

你遇到的问题对应测试代码如下：

class TestClass
{
public:
    static int testMember;

    template<class T> static  T* Foo()
    {
        //Defination....
    }
};
//int TestClass::testMember;  //Duplicate definition

核心是C++的**单定义规则（ODR）**约束：同一个全局符号在整个程序的所有编译单元中只能有一处定义，否则链接阶段会报重复定义错误，两类实体的链接属性差异导致了现象区别：

• 普通非inline静态成员变量属于外部链接符号：如果你把它的定义写在.hpp文件中，每一个引入该.hpp的.cpp编译单元都会单独生成一份该变量的实例，链接时多个同名全局符号冲突，就触发了你遇到的错误。
• 你示例中的模板成员函数可以正常放在头文件，是因为模板的实例化属于弱符号：多个编译单元实例化出的相同模板函数，链接器会自动选择其中一个保留，不会触发重定义错误。注意如果是非模板、非inline的普通成员函数，直接把定义写在.hpp里同样会触发重复定义错误。

不是必须，有多种合规的实现方式：

• 传统方案：将静态成员变量的定义放在单独的.cpp文件中，整个项目只会生成一份实例，不会出现符号冲突。
• C++17及更高版本方案：给静态成员变量添加inline修饰，直接在类内定义即可，内联变量属于弱符号，多编译单元重复定义时链接器会自动去重，示例写法：

  class TestClass
  {
  public:
      inline static int testMember = 0; // 直接在类内定义，无需额外外部定义
  };
  

• 模板方案：将静态成员变量作为模板类的成员，和模板函数同理，按需实例化的符号默认是弱符号，不会出现重定义问题。

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