导入mathparser.cpp类库遇LNK2005重复定义错误的原因及解决办法

错误原因 #

LNK2005错误的核心是链接器发现同一个函数/类方法存在多份重复定义，问题出在你直接#include "mathparser.cpp"的用法上：

• C++的#include指令会把目标文件内容原封不动嵌入当前源文件。当你在主文件中包含.cpp文件时，文件里的所有类方法实现都会被编译进主文件的目标（.obj）中。
• 如果你的项目同时把mathparser.cpp本身加入了编译列表，这个.cpp会单独生成一份.obj文件，里面同样包含所有方法的定义。链接阶段，两份.obj文件里的同名方法冲突，就会抛出重复定义错误。
• 哪怕只在主文件里包含.cpp，若主文件被其他源文件间接包含（比如其他文件#include主文件），也会导致代码重复嵌入，引发冲突。

修复方法 #

方法1：标准头文件+源文件分离（推荐）

这是C++项目的规范做法，能彻底解决问题且利于维护：

• 新建mathparser.h（或mathparser.hpp）文件，把mathparser.cpp里的类声明、函数原型复制进去（仅保留方法声明，比如class MathParser { public: int eval(const std::string& expr); };，不要把eval的实现代码放进来）。
• 在mathparser.h开头添加头文件保护，防止被重复包含：

  #ifndef MATHPARSER_H
  #define MATHPARSER_H
  
  // 此处放置类声明、必要的依赖头文件（比如<string>）
  class MathParser {
      // 类成员声明
  };
  
  #endif // MATHPARSER_H
  

• 保留mathparser.cpp里的类方法实现，确保它被添加到项目的编译列表中（不要从项目中移除）。
• 主文件中替换为#include "mathparser.h"，正常调用库方法即可。

方法2：临时应急方案（不推荐用于长期项目）

若不想重构文件，可采用以下临时方案：

• 确保项目没有把mathparser.cpp加入编译列表，仅在主文件中#include "mathparser.cpp"。这样库代码只会被编译一次，不会出现重复定义，但会导致主文件体积变大，且无法在其他源文件中复用该库，维护性差。
• 或者给mathparser.cpp里的所有类方法、全局函数加上inline关键字。inline会告诉链接器，即使多个编译单元有该函数的定义，也仅保留一份实现，不会触发重复定义错误。但注意，inline更适合简短函数，大量使用可能影响编译效率。

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