【23】C++实战篇——C++报错：LNK2001：无法解析的外部符号，LNK2019: 无法解析的外部符号，原因分析及解决方法

最新推荐文章于 2026-04-21 05:25:48 发布

原创最新推荐文章于 2026-04-21 05:25:48 发布 · 1.7k 阅读

17 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#c++ #C++报错LNK2001 #C++报错 #无法解析的外部符号 #LNK2019

C/C++ 实战篇专栏收录该内容

82 篇文章

订阅专栏

文章目录

1 问题描述
2 原因分析
3 解决方法
4 报错信息总结

报错信息

error LNK2001: 无法解析的外部符号 变量ImgSavePath ，ImgFormat
error LNK2019: 无法解析的外部符号 函数cam3Fun，func3

严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2001	无法解析的外部符号 "class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > ImgSavePath" (?ImgSavePath@@3V?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@A)	Projector

严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2019	无法解析的外部符号 "public: int __cdecl getLine::getLine_Border_Func(class cv::Mat,class cv::Point_<int>,class cv::Vec<double,2> &,class cv::Vec<double,4> &,class cv::Point_<float> &,class std::vector<class cv::Point_<float>,class std::allocator<class cv::Point_<float> > > &,bool,bool)" (?getLine_Border_Func@getLine@@QEAAHVMat@cv@@V?$Point_@H@3@AEAV?$Vec@N$01@3@AEAV?$Vec@N$03@3@AEAV?$Point_@M@3@AEAV?$vector@V?$Point_@M@cv@@V?$allocator@V?$Point_@M@cv@@@std@@@std@@_N6@Z)，函数 cam3Func 中引用了该符号	Projector

1 问题描述

如图，同一解决方案下有两个项目 Line ，Projector
（多个项目，多文件共用同一个外部变量）
在这里插入图片描述

其中在Line项目的 getLine文件中声明了外部变量

extern string ImgSavePath ;//测试存图路径
extern string ImgFormat ;//测试存图 后缀名

改外部变量除了在，Line的多文件中使用外；
还在Projector 中引用
在这里插入图片描述
现在要在Projector 项目中引用 getLine.h中声明的外部变量，；
于是在Projector 项目中包含getLine.h头文件，并添加了getLine.h头文件
（右键项目添加， Line ，Projector 共用一个头文件 getLine.h）

但运行报错： LNK2001: 无法解析的外部符号 ImgSavePath ，ImgFormat

在这里插入图片描述

2 原因分析

一般是链接时找不到相应的函数或者变量造成的，调用在头文件中声明的函数或者变量时导致链接时找不到，检查头文件和源文件中定义的函数或者变量名是否一一对应。

具体分为以下几种情况：

头文件中声明的函数或变量，没有在源文件或者链接的库文件中实现，如头文件中使用extern int abc声明了一个变量，而在其他源文件中并没有对其定义过而直接进行使用。就会导致出现error LNK2001错误；
没有包含实现该函数或者变量的源文件在项目工程中，对于不在项目工程的源文件，编译器不会进行编译，也就相当于其中的函数或变量没有被实现；
使用到了库中函数或变量而没有为编译器指明动态/静态链接库lib文件，导致链接器无法从库中找到函数或者变量；
函数或者变量在源文件中被static修饰， 被static修饰的函数和变量链接性为内部，只能在本文件内使用，在外部使用就会出现链接错误；

3 解决方法

结合我项目的问题描述，分析问题原因为：

调用在头文件中声明的者变量时，没有包含实现该变量的源文件在项目工程中，导致链接时找不到

解决方法 将getLine.h头文件对应的 .cpp 文件也添加到 Projector 项目中，解决；

（右键项目Projector --添加–现有项–在弹出的窗口中选择找到Line项目文件下getLine.cpp文件–添加完成，再次运行后，正常）
在这里插入图片描述

在这里插入图片描述

4 报错信息总结

通过对报错信息对比发现：
error LNK2001: 无法解析的外部符号——— 一般是找不到对应的变量
error LNK2019: 无法解析的外部符号——— 一般是找不到对应的函数

error LNK2001: 无法解析的外部符号 变量ImgSavePath ，ImgFormat
error LNK2019: 无法解析的外部符号 函数cam3Fun，func3

下面是具体的报错信息

严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2001	无法解析的外部符号 "class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > ImgSavePath" (?ImgSavePath@@3V?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@A)	Projector	

严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2001	无法解析的外部符号 "class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > ImgSavePath" (?ImgSavePath@@3V?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@A)	Projector	

严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2001	无法解析的外部符号 "class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > ImgFormat" (?ImgFormat@@3V?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@A)	Projector		

严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2001	无法解析的外部符号 "class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> > ImgFormat" (?ImgFormat@@3V?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@A)	Projector		


严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2019	无法解析的外部符号 "public: int __cdecl getLine::getLine_Border_Func(class cv::Mat,class cv::Point_<int>,class cv::Vec<double,2> &,class cv::Vec<double,4> &,class cv::Point_<float> &,class std::vector<class cv::Point_<float>,class std::allocator<class cv::Point_<float> > > &,bool,bool)" (?getLine_Border_Func@getLine@@QEAAHVMat@cv@@V?$Point_@H@3@AEAV?$Vec@N$01@3@AEAV?$Vec@N$03@3@AEAV?$Point_@M@3@AEAV?$vector@V?$Point_@M@cv@@V?$allocator@V?$Point_@M@cv@@@std@@@std@@_N6@Z)，函数 cam3Func 中引用了该符号	Projector		


严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2019	无法解析的外部符号 "public: bool __cdecl getLine::getLineCrossPoint2f(class cv::Mat,class cv::Mat,class std::basic_string<char,struct std::char_traits<char>,class std::allocator<char> >,class cv::Point_<int>,class cv::Point_<float> &,bool)" (?getLineCrossPoint2f@getLine@@QEAA_NVMat@cv@@0V?$basic_string@DU?$char_traits@D@std@@V?$allocator@D@2@@std@@V?$Point_@H@3@AEAV?$Point_@M@3@_N@Z)，函数 cam3Func 中引用了该符号	Projector	
		
严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK2019	无法解析的外部符号 "public: int __cdecl getLine::getLine_Test(void)" (?getLine_Test@getLine@@QEAAHXZ)，函数 "int __cdecl func3(void)" (?func3@@YAHXZ) 中引用了该符号	Projector

最后一个错误信息，是由上面几个问题引起的

严重性	代码	说明	项目	文件	行	禁止显示状态	详细信息
错误	LNK1120	5 个无法解析的外部命令	Projector