无明显诱因出现LNK2001及其他链接器错误求助

问题详情 #

无明显诱因出现链接器错误，相关源码及错误输出如下：

PZ_Buffer.h #

#pragma once

#include <glad/gl.h>
#include <stdint.h>
#include <vector>

class VertexBuffer
{
    uint32_t m_BufferID = 0;
public:
    VertexBuffer(std::vector<float> data, size_t size);
    ~VertexBuffer();

    void Bind() const;
    void Unbind() const;
};

class IndexBuffer
{
    uint32_t m_BufferID = 0;
    size_t m_Count = 0;
public:
    IndexBuffer(std::vector<uint32_t> data, size_t size, size_t count);
    ~IndexBuffer();

    inline size_t GetCount() { return m_Count; }

    void Bind() const;
    void Unbind() const;
};

PZ_Buffer.cpp #

#include "PZ_Buffer.h"

VertexBuffer::VertexBuffer(std::vector<float> data, size_t size)
    : m_BufferID(0)
{
    glGenBuffers(1, &m_BufferID);
    glBindBuffer(GL_ARRAY_BUFFER, m_BufferID);
    glBufferData(GL_ARRAY_BUFFER, size * sizeof(float), data.data(), GL_STATIC_DRAW);
}

VertexBuffer::~VertexBuffer()
{
    glDeleteBuffers(1, &m_BufferID);
}

void VertexBuffer::Bind() const
{
    glBindBuffer(GL_ARRAY_BUFFER, m_BufferID);
}

void VertexBuffer::Unbind() const
{
    glBindBuffer(GL_ARRAY_BUFFER, 0);
}

IndexBuffer::IndexBuffer(std::vector<uint32_t> data, size_t size, size_t count)
    : m_BufferID(0), m_Count(count)
{
    glGenBuffers(1, &m_BufferID);
    glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, m_BufferID);
    glBufferData(GL_ELEMENT_ARRAY_BUFFER, size * sizeof(uint32_t), data.data(), GL_STATIC_DRAW);
}

IndexBuffer::~IndexBuffer()
{
    glDeleteBuffers(1, &m_BufferID);
}

void IndexBuffer::Bind() const
{
    glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, m_BufferID);
}

void IndexBuffer::Unbind() const
{
    glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, 0);
}

控制台错误信息 #

1>PZ_Level.obj : error LNK2019: unresolved external symbol "public: virtual __thiscall VertexBuffer::~VertexBuffer(void)" (??1VertexBuffer@@UAE@XZ) referenced in function "public: virtual void * __thiscall VertexBuffer::`scalar deleting destructor'(unsigned int)" (??_GVertexBuffer@@UAEPAXI@Z)
1>PZ_Level.obj : error LNK2001: unresolved external symbol "public: virtual void __thiscall VertexBuffer::Bind(void)const " (?Bind@VertexBuffer@@UBEXXZ)
1>PZ_Level.obj : error LNK2001: unresolved external symbol "public: virtual void __thiscall VertexBuffer::Unbind(void)const " (?Unbind@VertexBuffer@@UBEXXZ)
1>PZ_Level.obj : error LNK2019: unresolved external symbol "public: virtual __thiscall IndexBuffer::~IndexBuffer(void)" (??1IndexBuffer@@UAE@XZ) referenced in function "public: virtual void * __thiscall IndexBuffer::`scalar deleting destructor'(unsigned int)" (??_GIndexBuffer@@UAEPAXI@Z)
1>PZ_Level.obj : error LNK2001: unresolved external symbol "public: virtual void __thiscall IndexBuffer::Bind(void)const " (?Bind@IndexBuffer@@UBEXXZ)
1>PZ_Level.obj : error LNK2001: unresolved external symbol "public: virtual void __thiscall IndexBuffer::Unbind(void)const " (?Unbind@IndexBuffer@@UBEXXZ)

使用编译器为MSVC 2022，已查阅官方文档及相关高赞解答未解决，需详细排查方案。

解决步骤 #

1. 确认源文件已加入项目 #

• 右键项目 → 添加 → 现有项，选择PZ_Buffer.cpp加入项目。
• 若文件已在项目中，右键文件查看属性，确保项类型为C/C++编译器，而非文本文件或其他类型。

2. 清理编译缓存并验证头文件一致性 #

错误信息中函数被标记为virtual，但源码中未声明虚函数，说明可能存在旧版头文件引用：

• 点击生成 → 清理解决方案，删除项目目录下的Debug/Release文件夹，重新生成。
• 检查所有引用PZ_Buffer.h的文件，确保没有引用其他目录下的同名旧文件。

3. 统一编译选项 #

确保PZ_Buffer.cpp和PZ_Level.cpp的编译选项完全一致：

• 右键两个文件 → 属性，检查C/C++ → 所有选项中的运行库、字符集、平台工具集，统一为相同配置后重新编译。

4. 检查命名空间与符号修饰 #

确认代码中没有用extern "C"包装C类（会破坏MSVC的C名称修饰规则），若PZ_Buffer.h中有不当的extern "C"块，直接移除。

5. 测试内联成员函数 #

将头文件中的简单成员函数改为内联实现，验证是否链接成功：

// 修改PZ_Buffer.h
class VertexBuffer
{
    // ...
public:
    // ...
    void Bind() const { glBindBuffer(GL_ARRAY_BUFFER, m_BufferID); }
    void Unbind() const { glBindBuffer(GL_ARRAY_BUFFER, 0); }
};

class IndexBuffer
{
    // ...
public:
    // ...
    void Bind() const { glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, m_BufferID); }
    void Unbind() const { glBindBuffer(GL_ELEMENT_ARRAY_BUFFER, 0); }
};

若错误消失，说明原.cpp文件未被正确编译链接，回到步骤1重新检查项目配置。

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