C++纯虚函数头声明+cpp实现出现LNK2001未解析外部符号问题

遇到的错误 #

error LNK2001: unresolved external symbol "public: virtual class AElementActor * __cdecl ElementFactory::CreateElement(int,int,int)" (?CreateElement@ElementFactory@@UEAAPEAVAElementActor@@HHH@Z)

原始代码结构 #

IElementFactory.h #

struct IElementFactory
{

public:

    virtual AElementActor* CreateElement(
        int NeutronCount,
        int ProtonCount,
        int ElectronCount) = 0;

};

ElementFactory.h #

#include "IElementFactory.h"

class ElementFactory : public IElementFactory
{

public:
    
    AElementActor* CreateElement(
        int NeutronCount,
        int ProtonCount,
        int ElectronCount) override;

};

ElementFactory.cpp #

AElementActor* ElementFactory::CreateElement(
    int NeutronCount,
    int ProtonCount,
    int ElectronCount)
{
    // ...
}

现象 #

将CreateElement的定义移至头文件中，程序即可正常编译：

更新后的ElementFactory.h #

#include "IElementFactory.h"

class ElementFactory : public IElementFactory
{

public:
    
    AElementActor* CreateElement(
        int NeutronCount,
        int ProtonCount,
        int ElectronCount) override
    {
        // ...
    }

};

问题 #

这是怎么回事？纯虚函数的实现必须放在头文件中，或者至少全部放在cpp文件中吗？

原因分析与解答 #

这个LNK2001错误和纯虚函数的实现位置无关，核心问题是你的项目编译链接时，没有把ElementFactory.cpp纳入编译流程，或者该文件的编译产物没被链接到最终可执行文件里。

当你把函数定义移到头文件后，编译器会在每个包含该头文件的编译单元中生成函数代码（内联展开或生成副本，最终链接时会自动合并重复定义），自然就不会出现链接缺失的问题。

关于纯虚函数的实现规则： #

• 纯虚函数（带=0的虚函数）完全可以在cpp文件中实现，你最初的写法本身语法是合法的，只要确保实现它的cpp文件被正确编译链接就行。
• 抽象类（含至少一个纯虚函数的类）不能实例化，但纯虚函数本身允许有实现，实现位置既可以在头文件的类内部，也可以在cpp文件的类外部。

修复最初写法的方法： #

1. 检查项目设置，确认ElementFactory.cpp已经添加到项目的编译文件列表里，没有被标记为“不参与编译”。
2. 确保编译生成的ElementFactory.obj（对应平台的目标文件）被包含在链接步骤中，没有被遗漏。

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