关于形如--error LNK2005: xxx 已经在 msvcrtd.lib ( MSVCR90D.dll ) 中定义--的问题分析解决
此随笔主要来自http://www.cnblogs.com/qinfengxiaoyue/archive/2013/02/01/2889668.html
引自:http://blog.csdn.net/sptoor/archive/2011/02/23/6203376.aspx
关键词:程序库、CRT、LIBCMTD.lib、MSVCRTD.lib、链接库的冲突问题、MSVC链接处理
1. 问题的引出
此篇文章主要谈谈程序库 (Library) 链接,以及关于 MSVC 与 CRT 之间的种种关系。
此篇文章主要面向操作系统是 Windows,程序开发环境是 MSVC,撰写 C++ 程序的同学。
有时,我们在生成程序时,会遇到一些链接错误,例如:
1>libcmtd.lib(errmode.obj) : error LNK2005: ___set_app_type 已经在msvcrtd.lib(MSVCR90D.dll) 中定义
1>libcmtd.lib(dbgrptw.obj) : error LNK2005: __CrtDbgReport已经在msvcrtd.lib(MSVCR90D.dll) 中定义
1>msvcrtd.lib(MSVCR90D.dll) : error LNK2005: __setmbcp 已经在libcmtd.lib(mbctype.obj) 中定义
1>LINK:warning LNK4098:默认库“msvcrtd.lib”与其他库的使用冲突;请使用/NODEFAULTLIB:library
1>msvcrtd.lib(cinitexe.obj) : warning LNK4098: 默认库“libcmtd.lib”与其他库的使用冲突;请使
用/NODEFAULTLIB:library
.....................
一般来说,如果在你的程序项目中有使用某些由他人所撰写的第三方程序库或是开源项目的程序库,比较容易会发生上述的错误状况。
从上述这些看似离奇而令人摸不着头线程的错误信息中,我们大概可以猜测问题点应该在于 LIBCMTD.lib与 MSVCRTD.lib 这两个程序库身上。但到底什么是 LIBCMTD.lib 和 MSVCRTD.lib?在我们的程序代码中有使用这些程序库吗?答是肯定的。
2.C Runtime Library(C运行时库)
熟悉 C 语言的程序设计者都知道,如果要使用 printf()、scanf() 或者 fopen() 等等 C 语言的基本 I/O 操作函数时,首先必须用 #include 语法将 stdio.h 这个标头文件纳入我们的程序代码中。藉由 stdio.h 中对这些 I/O 操作函数所做出的函数声明 (function declaration),编译器 (Compiler) 才得以确认 printf、scanf 以及 fopen 等等都是合法可用的函数。
而当我们撰写的程序代码经过编译器产出 OBJ 形式的文件之后,需要再经由链接器 (Linker) 的处理程序,将程序代码中全部有使用到的函数定义 (function definition) 链接生成起来,才能够产生出最后的程序执行文件。问题来了,我们知道 printf、scanf 以及 fopen 的函数声明存在于 stdio.h 当中,但是这些函数的定义,也就是真正的定义程序代码,究竟存放在什么地方呢? 在 C 语言的标准程序库中。
由 C 语言所制订的标准程序库,称之为「执行阶段程序库」,也就是 C Run-Time Library,通常可简称为 CRT。在 C 语言的标准程序库中,包含了一组常用的基础函数,例如 I/O 处理与字符串操作程序等等,所以只要我们使用 C 语言撰写程序代码,就一定要将编译完成后的程序代码 OBJ 文件,链接至 C 语言的执行阶段程序库,才能够产生出合法的 C 语言程序执行文件。
而 CRT 并非只有单一一种版本存在。事实上,除了可以依「Debug」与「Release」用途分成两个版本之外,两者又可分别衍生分出「静态链接」与「动态链接」两种形式:
静态链接:
LIBCMTD.lib(Debug版本)
LIBCMT.lib
动态链接:
MSVCRTD.lib(Debug版本)
MSVCRT.lib
虽然这四个 CRT 版本的用途与使用方式各不相同,但却有个共通的特点,就是它们都是满足执行线程安全需求,可在多执行线程程序代码中安全使用的程序库版本。事实上,在过去 MSVC 6 的版本中,本来还有另外两个 LIBCD.lib(Debug版本)与 LIBC.lib 程序库,是专门给单执行线程程序使用的 CRT 版本,但是这两个选项自 MSVC 2005 开始就从设定选项中被删除掉了,所以现在大多数程序设计者使用的都是多执行线程的 CRT 版本。
在程序库链接 (library linking) 的行为中,静态链接和动态链接的分别,在于使用静态链接时,会直接将程序库的函数定义嵌入执行文件之中,而使用动态链接时,程序库的函数定义则存在于另外的独立文件,通常是 DLL 格式的文件中,然后与程序执行文件一同发布给使用者。因此在文件的尺寸上,使用动态链接的执行文件文件,通常会比使用静态链接的执行文件文件更小一些。
使用动态链接 CRT 版本的好处,是能够将经常使用到的标准程序库们独立出来,放在 Windows 的系统文件夹中,以减少生成出来的执行文件文件尺寸。但反过来说,使用动态链接 CRT 版本的缺点也在于这些与执行文件相依为命的 DLL 文件上。举例来说,如果程序以 MSVC 2005 生成出 Debug 态的执行文件,则此执行文件需要有 msvcr80d.dll 存在才能顺利执行;如果是 Release 态,则相依于 msvcr80.dll。但是如果把相同的程序代码拿到 MSVC 2008 上生成,产生出来的执行文件则相依于 msvcr90d.dll 与 msvcr90.dll 两个不同的 DLL 文件。不同版本的 MSVC,都会有各自不同的相依 DLL 文件。
在 MSVC 的程序项目中,如何指定程序代码要使用静态链接或者动态链接的 CRT 版本?其实很容易,只要在项目属性的「C/C++」页面中,选择「程序代码产生」(Code Generation) 子页面,其中有个「执行阶段程序库」(Runtime Library)的项目,也就是项目中用来设定 CRT 链接版本的地方。其中总共有四个选项,正好对应于上述静态链接与动态链接的四个不同程序库版本。
多执行线程调试 (/MTd):对应 LIBCMTD.lib
多执行线程 (/MT):对应 LIBCMT.lib
多执行线程调试 DLL (/MDd):对应 MSVCRTD.lib
多执行线程 DLL (/MD):对应 MSVCRT.lib
如果没有做任何设定就开始生成程序的话,MSVC 的预设选项则会使用动态链接的版本。
3.Standard C++ Library(标准C++库)
请注意,以上只是单纯 C 语言的程序库而没有包含 C++ 语言在内。如果程序系统中,有包含 C++ 语言的程序代码的话,那又是另外一回事了。但是在项目属性的页面中,为什么找不到相关的设定选项呢?因为 MSVC 悄悄地帮程序设计者代劳处理掉了。只要在程序代码中使用 #include 语法纳入任何一个 C++ 的标头文件,例如 iostream 或 fstream,MSVC 就会在链接器的运作阶段中,自动帮我们链接 C++ 的执行阶段程序库。而 C++ 的执行阶段程序库,同样可分为四个版本:
静态链接:
LIBCPMTD.lib(Debug版本)
LIBCPMT.lib
动态链接:
MSVCPRTD.lib(Debug版本):执行文件相依于 MSVCP90D.dll
MSVCPRT.lib:执行文件相依于 MSVCP90.dll
至于程序执行文件使用的是静态链接或者动态链接的版本,就仰赖于 C 语言的版本设定选项了。举个例子来说,如果撰写了一个 Debug 组态的 C++ 程序,并且保留项目原先预设的生成选项(动态链接),那么最终生成出来的程序执行文件将会相依于 MSVCR90D.dll 以及 MSVCP90D.dll 两个 DLL 文件。如果将相同的程序以 Release 组态生成完成,则会相依于MSVCR90.dll 以及 MSVCP90.dll 二者。
4.问题分析及解决
刚学习程序设计的入门者,经常会在满心欢喜地完成一件程序作品并且传给其他人使用时,却发现不能在别人的电脑上启动程序,其实就是陷入了使用者电脑缺少 DLL文件而无法执行程序的窘境。有三种方法可以解决这个令人困扰的问题:
1 . 使用者的电脑,必须先安装「Visual C++开发套件」(MSVC 2008 或 MSVC 2005 )。
2 . 将所需的 DLL文件,例如 MSVCR90D.dll与MSVCP90.dll,直接附在程序的下载包当中。
3 . 以静态链接方式生成程序执行文件。
当无法确定自己的程序或别人的程序,是否相依于某些特定的 DLL文件时,有一个非常好用的免费工具程序 Dependency Walker,可以开启 EXE格式的执行文件或者 DLL格式的动态程序库,然后详细地条列出它们所相依的 DLL文件。
了解了几种不同的 CRT版本选项之后,回到最前面的错误信息问题,相信各位现在应该能够很清楚地理解,原来会发生这些奇怪的错误状况,是因为程序同时链接了 LIBCMTD.lib与MSVCRTD.lib而造成函数定义版本冲突。也就是说,程序链接器已经在其中一个 CRT的版本中找到所需的函数定义,但此时却又跳出另外一位 CRT,也给了一份相同函数的实现版本,所以链接器无法判断应该忽略谁并且选择谁。
而这个状况的发生原因,就是你的程序与程序所链接的外部程序库,使用了不同的 CRT版本之故。例如,当你的程序使用了Lua,自然必须链接至 Lua的程序库 lua5.1.lib,但如果lua5.1.lib是以静态链接版本的 CRT生成而成,而你的程序却是以预设选项,动态链接 CRT 来生成程序执行文件的话,如此一来就会产生上述这些错误信息了。至此,问题的答已昭然若揭,解决方法有二种:
其一是将Lua重新以动态链接 CRT 的方式生成出一个新的程序库;
其二则是将自己的程序项目改成以静态链接 CRT 方式生成。
换个角度想,当你身为一位程序库的设计开发者,想要将自己写的东西分享给其他人,但又不想要完全开放自己撰写的程序源码时,至少可以同时提供以下四种版本的程序库,以妥善满足使用者的各种不同需求:
Debug:动态链接Debug版本
Release:动态链接版本
Debug_Static:静态链接Debug版本
Release_Static:静态链接版本
然而,有时候世界并不会运作得如此理想。在某些特殊的状况下,当我们使用他人所写的第三方程序库时,有时可能只拿得到其中某个特定的版本,例如 Release_Static版本时,就很有可能会遇到程序库冲突的错误情形。此时就需要视项目的实际需求而定,可以在项目属性中指定「忽略特定程序库」(Ignore Specific Library)这个选项,让程序代码链接器忽略某些程序库,以此化解动静程序库或新旧程序库之间的恩怨冲突。
小测验:你所撰写的程序,必须链接某个以静态多执行线程 (/MT) CRT 生成而成的程序库。如果你的程序在 Debug组态下以多执行线程侦错 (/MTd)选项生成,是否会产生冲突?如果你的程序在 Release组态下以多执行线程 (/MT) 选项生成,是否会产生冲突?是的话,应该如何解决?
上面的方法还是不行!会出现其他问题的。
以下是我摸索出的最新的解决方法:
首先,所有的lib文件,使用/MTd或/MT编译(注:即静态链接模式)。Debug调试模式使用/MTd,Release模式使用/MT。然后,在自己的程序中也使用/MTd或/MT编译。这样就不会出问题了。
三种编译链接库的方式:
(1)连接Windows库。针对Win32 API编写的应用程序,上面的方法可能带来新问题,可以忽略libcmt.lib库,即可。如果还有其他问题,再忽略相应的库。
(2)MFC静态链接。上面的方法就是针对这种链接方式的,所以没问题。
(3)MFC动态链接。没有试过,应该和(1)类似。
最后补充:如果还不行,直接加入/force:multiple编译参数吧。这次之所以没有使用它,也是为了严谨起见。
----------------------------------------------------------------------------------------------
以上基本是从http://www.cnblogs.com/qinfengxiaoyue/archive/2013/02/01/2889668.html中转过来的,稍微做了删减。
下面是我在实际生成程序时遇到的问题。
在生成Release版本的程序时,必须的忽略掉LIBCMTD.lib。
通过阅读转帖中的内容,得出结论,是应用程序引用的一个lib库用到了LIBCMTD.lib。但是,用到LIBCMTD.lib的库,应该是Debug版本的。经确认,该lib确实是Debug版本的,之所以出错是因为该lib的Release版本和Debug版本的命名相同,所以搞错了。
以后在程序开发过程中应注意:
1. 如果链接过程中,需要忽略LIBCMTD.lib,那么该程序引用的lib中有使用了LIBCMTD.lib的lib。
2. 如果生成Release版本的程序,需要忽略LIBCMTD.lib,那么说明引用的第三方库中有Debug版本的;反之亦然。(此情况应该很少见)
3. 生成lib、dll时,应该在命名上区分Debug、Release版本。