编译电子表格代码时CellValueBase基类构造函数多重定义错误

这个链接错误是C++开发里非常常见的问题，本质是你的CellValueBase构造函数的实现被编译进了多个目标文件（比如这里的sheet.o和Column.o），链接器无法确定该使用哪一份定义，因此抛出错误。下面是具体的排查和解决步骤：

• 第一步：检查头文件的包含保护
  首先打开定义CellValueBase的头文件（比如CellValueBase.h），确认是否添加了头文件保护宏或#pragma once。如果没有，每个包含该头文件的.cpp文件都会重新编译整个类的定义（包括构造函数实现），导致多个目标文件中出现重复的构造函数定义。
  标准的头文件保护写法如下：

  #ifndef CELL_VALUE_BASE_H
  #define CELL_VALUE_BASE_H
  
  // 此处是CellValueBase的类定义代码
  
  #endif // CELL_VALUE_BASE_H
  

  也可以用更简洁的#pragma once（主流编译器均支持），直接放在头文件最开头即可。

• 第二步：调整构造函数的实现位置
  如果头文件已经加了保护，问题大概率是你将CellValueBase::CellValueBase()的实现写在了头文件中，且未使用inline关键字修饰：

  • 若构造函数直接写在类内部实现，需要给构造函数加上inline关键字，告诉编译器该函数允许在多个编译单元中存在，链接时不会视为重复定义：

    class CellValueBase {
    public:
        inline CellValueBase() {
            // 构造函数逻辑代码
        }
    };
    

  • 若构造函数在类外部但仍写在头文件中，同样需要添加inline：

    class CellValueBase {
    public:
        CellValueBase(); // 仅保留声明
    };
    
    inline CellValueBase::CellValueBase() {
        // 构造函数逻辑代码
    }
    

  • 更稳妥的方式是将构造函数的实现移到单独的.cpp文件（比如CellValueBase.cpp），头文件仅保留声明：

    // CellValueBase.h
    class CellValueBase {
    public:
        CellValueBase(); // 仅声明
    };
    
    // CellValueBase.cpp
    #include "CellValueBase.h"
    CellValueBase::CellValueBase() {
        // 构造函数逻辑代码
    }
    

    这样只会在CellValueBase.o中生成一份构造函数定义，链接时就不会出现冲突。

• 第三步：排查低级重复定义错误
  偶尔会出现不小心在多个.cpp文件中重复编写CellValueBase::CellValueBase()实现的情况，这种时候直接删除多余的实现，只保留一份即可。

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