c++ error LNK2005......错误解决方法

关注

原创最新推荐文章于 2026-06-14 12:39:42 发布 1.7w 阅读 AI 写同款· GEO 优化 ›

Visual Studio避坑指南：LNK2005错误的5种常见原因及修复方法本文深入解析Visual Studio中常见的LNK2005错误，详细介绍了5种导致重复定义的常见原因及修复方法，包括全局变量、头文件包含、静态成员变量、第三方库冲突和函数定义问题。通过实战案例和最佳实践，帮助C++开发者有效避免和解决这一经典链接错误，提升开发效率。阅读详情

错误如图

解决方案：

一

今天被error LNK2005这个问题折腾了好久好久，从网上找了一些文章看了看，大多数都说是头文件包含比较混乱，同一个文件被多个文件包含了；还有的说是某两个.dll文件被忽略还是包含了什么的，但是试了这两个方法都不行，因为我新写的函数只被一个文件包含了，而且我也没改过任何的.dll文件。后来尝试了很多方法，这个问题终于被解决了（只要在你想包含的文件中的每个函数前加一个static，声明其为局部函数即可，对于被包含的文件中的全局变量也是加一个static即可），方法如下：

我的运行平台是 VS2005 vc++.net (CRL)，我使用了windows form，想在form1中点击某个按钮时调用一个已经写好的c++程序。

起初我的被包含的文件为abc.cpp，并且已经被包含中form1.h中（#include "abc.cpp"）

abc.cpp中的函数fun1定义如下：

int fun1(int c){return c;}

但是一编译就出项如下问题：

main_test.obj : error LNK2005: "int __cdecl fun1(int)" (?fun1@@YAHH@Z) already defined in Mysystem.obj

所有的都不变，只要将fun1定义改为：

static int fun1(int c){return c;}就可以了！！

具体原因我也不太清楚，可能的解释是在CRL中，如果某个被包含文件中的函数定义前不加static，则该函数将被视为全局函数，而static后其作用域只限于被包含的文件。。。。解释待续。。。。——————http://hi.baidu.com/zhjiaqing/blog/item/2f8074256a324e6e34a80ff5.html

二编程中经常能遇到LNK2005错误——重复定义错误，其实LNK2005错误并不是一个很难解决的错误。弄清楚它形成的原因，就可以轻松解决它了。
　　
　　造成LNK2005错误主要有以下几种情况：
　　1．重复定义全局变量。可能存在两种情况：
　　 A、对于一些初学编程的程序员，有时候会以为需要使用全局变量的地方就可以使用定义申明一下。其实这是错误的，全局变量是针对整个工程的。正确的应该是在一个 CPP文件中定义如下：int g_Test;那么在使用的CPP文件中就应该使用：extern int g_Test即可，如果还是使用int g_Test，那么就会产生LNK2005错误，一般错误错误信息类似：AAA.obj error LNK2005 int book c？book@@3HA already defined in BBB.obj。切记的就是不能给变量赋值否则还是会有LNK2005错误。
　　这里需要的是“声明”，不是“定义”！根据C++标准的规定，一个变量是声明，必须同时满足两个条件，否则就是定义：
　　 (1)声明必须使用extern关键字；(2)不能给变量赋初值
　　所以，下面的是声明:
　　 extern int a;
　　下面的是定义
　　 int a; int a = 0; extern int a =0;
　　 B、对于那么编程不是那么严谨的程序员，总是在需要使用变量的文件中随意定义一个全局变量，并且对于变量名也不予考虑，这也往往容易造成变量名重复，而造成LNK2005错误。
　　
　　 2．头文件的包含重复。往往需要包含的头文件中含有变量、函数、类的定义，在其它使用的地方又不得不多次包含之，如果头文件中没有相关的宏等防止重复链接的措施，那么就会产生LNK2005错误。解决办法是在需要包含的头文件中做类似的处理：#ifndef MY_H_FILE //如果没有定义这个宏
　　 #define MY_H_FILE //定义这个宏
　　 ……. //头文件主体内容
　　 …….
　　 #endif
　　上面是使用宏来做的，也可以使用预编译来做，在头文件中加入：
　　 #pragma once
　　 //头文件主体
　　 3．使用第三方的库造成的。这种情况主要是C运行期函数库和MFC的库冲突造成的。具体的办法就是将那个提示出错的库放到另外一个库的前面。另外选择不同的C 函数库，可能会引起这个错误。微软和C有两种C运行期函数库，一种是普通的函数库：LIBC.LIB，不支持多线程。另外一种是支持多线程的： msvcrt.lib。如果一个工程里，这两种函数库混合使用，可能会引起这个错误，一般情况下它需要MFC的库先于C运行期函数库被链接，因此建议使用支持多线程的msvcrt.lib。所以在使用第三方的库之前首先要知道它链接的是什么库，否则就可能造成LNK2005错误。如果不得不使用第三方的库，可以尝试按下面所说的方法修改，但不能保证一定能解决问题，前两种方法是微软提供的：
　　 A、选择VC菜单Project->Settings->Link->Catagory选择Input，再在Ignore libraries 的Edit栏中填入你需要忽略的库，如：Nafxcwd.lib;Libcmtd.lib。然后在Object/library Modules的Edit栏中填入正确的库的顺序，这里需要你能确定什么是正确的顺序，呵呵，God bless you！
　　 B、选择VC菜单Project->Settings->Link页，然后在Project Options的Edit栏中输入/verbose:lib，这样就可以在编译链接程序过程中在输出窗口看到链接的顺序了。
　　 C、选择VC菜单Project->Settings->C/C++页，Catagory选择Code Generation后再在User Runtime libraray中选择MultiThread DLL等其他库，逐一尝试。
　　关于编译器的相关处理过程，参考：
　　 http://www.donews.net/xzwenlan/archive/2004/12/23/211668.aspx
　　
　　这就是我所遇到过的LNK2005错误的几种情况，肯定还有其他的情况也可能造成这种错误，所以我不希望你在看完这篇文章以后，再遇到LNK2005错误时候，不动脑筋的想对号入座的排除错误。编程的过程就是一个思考的过程，所以还是多多开动你的头脑，那样收获会更多！ ————http://blog.csdn.net/chu_qun/article/details/3452614