error LNK2019 无法解析的外部符号

最新推荐文章于 2025-04-02 23:56:08 发布

转载最新推荐文章于 2025-04-02 23:56:08 发布 · 1k 阅读

文章标签：

#C++

C++ 专栏收录该内容

23 篇文章

订阅专栏

本文探讨了内联函数的定义位置及其引发的LNK2019错误。通常情况下，内联函数应直接定义在头文件中以避免链接时出现未解析的外部符号错误。

转载地址http://www.programlife.net/error-lnk2019.html

一个常识性错误，关于内联函数的（error LNK2019 无法解析的外部符号）

通常编写函数时，会把声明放到头文件（*.h）中，而把函数定义放在源文件（*.cpp）中，在其他源文件中使用时包含对应的头文件即可。但是内联函数（inline）不要定义在cpp文件中，因为我们通常都是包含头文件，而编译器在编译时会对内联函数进行展开操作，但是编译器只能在包含的头文件里搜索函数的定义体，如果头文件只有声明，显然编译器不知道该如何展开，于是就出错了。

每一个使用内联函数的地方，都应该知道内联函数的定义，所以内联函数就直接定义在头文件中。

一个错误的例子：

// Test.h
#ifndef _TEST_H
#define _TEST_H

class CTest
{
public:
    /*inline */void FooBar();
    //{
    //    printf("FooBar() called.\n");
    //}
};

#endif

// Test.cpp
#include "Test.h"
#include <stdio.h>

inline void CTest::FooBar()
{
    printf("FooBar() called.\n");
}

// Main.cpp
#include <stdio.h>
#include "Test.h"

int main(int argc, char **argv)
{
    CTest test;
    test.FooBar();

    return 0;
}

Visual Studio会抱怨：Main.obj : error LNK2019: 无法解析的外部符号 “public: void __thiscall CTest::FooBar(void)” (?FooBar@CTest@@QAEXXZ)，该符号在函数 _main 中被引用不过，既然内联函数在编译器就要展开，那为何在链接时才报错呢？这一点不是很明白，微软MSDN是这么说的：
同样，如果项目使用函数内联，但在 .cpp 文件（而非头文件）中定义函数，也会得到 LNK2019。头文件包含在任何被认为合适的位置，但只有在 .cpp 文件通过编译器时函数才内联；因此当函数用于其他模块时，链接器将函数看成无法解析的外部对象。