学习
VC
++时经常会遇到链接错误
LNK2001
,该错误非常讨厌,因为对于
编程者来说,最好改的错误莫过于编译错误,而一般说来发生连接错误时,
编译都已通过。产生连接错误的原因非常多,尤其 LNK2001 错误,常常使人不
明其所以然。如果不深入地学习和理解 VC ++,要想改正连接错误 LNK2001 非
常困难。
初学者在学习 VC ++的过程中,遇到的 LNK2001 错误的错误消息主要为:
unresolved external symbol “symbol” (不确定的外部 “ 符号 ” )。
如果连接程序不能在所有的库和目标文件内找到所引用的函数、变量或
标签,将产生此错误消息。一般来说,发生错误的原因有两个:一是所引用
的函数、变量不存在、拼写不正确或者使用错误;其次可能使用了不同版本
的连接库。
以下是可能产生 LNK2001 错误的原因:
一.由于编码错误导致的 LNK2001 。
1 .不相匹配的程序代码或模块定义( .DEF )文件能导致 LNK2001 。例如 ,
如果在 C ++ 源文件内声明了一变量 “var1” ,却试图在另一文件内以变量
“VAR1” 访问该变量 , 将发生该错误。
2 .如果使用的内联函数是在 .CPP 文件内定义的,而不是在头文件内定
义将导致 LNK2001 错误。
3 .调用函数时如果所用的参数类型同函数声明时的类型不符将会产生
LNK2001 。
4 .试图从基类的构造函数或析构函数中调用虚拟函数时将会导致 LNK2001 。
5 .要注意函数和变量的可公用性,只有全局变量、函数是可公用的。
静态函数和静态变量具有相同的使用范围限制。当试图从文件外部访问
任何没有在该文件内声明的静态变量时将导致编译错误或 LNK2001 。
函数内声明的变量(局部变量) 只能在该函数的范围内使用。
C ++ 的全局常量只有静态连接性能。这不同于 C ,如果试图在 C ++的
多个文件内使用全局变量也会产生 LNK2001 错误。一种解决的方法是需要时在
头文件中加入该常量的初始化代码,并在 .CPP 文件中包含该头文件;另一种
方法是使用时给该变量赋以常数。
二.由于编译和链接的设置而造成的 LNK2001
1 .如果编译时使用的是 /NOD ( /NODEFAULTLIB )选项,程序所需要的运行
库和 MFC 库在连接时由编译器写入目标文件模块, 但除非在文件中明确包含
这些库名,否则这些库不会被链接进工程文件。在这种情况下使用 /NOD 将导
致错误 LNK2001 。
2 .如果没有为 wWinMainCRTStartup 设定程序入口,在使用 Unicode 和 MFC
时将得到 “unresolved external on _WinMain@16” 的 LNK2001 错误信息。
3 .使用 /MD 选项编译时 , 既然所有的运行库都被保留在动态链接库之内,
源文件中对 “func” 的引用,在目标文件里即对 “__imp__func” 的引用。
如果试图使用静态库 LIBC.LIB 或 LIBCMT.LIB 进行连接,将在 __imp__func 上发
生 LNK2001 ;如果不使用 /MD 选项编译,在使用 MSVCxx.LIB 连接时也会发生 LNK2001 。
4 .使用 /ML 选项编译时,如用 LIBCMT.LIB 链接会在 _errno 上发生 LNK2001 。
5 .当编译调试版的应用程序时,如果采用发行版模态库进行连接也会产
生 LNK2001 ;同样,使用调试版模态库连接发行版应用程序时也会产生相同的
问题。
6 .不同版本的库和编译器的混合使用也能产生问题,因为新版的库里可
能包含早先的版本没有的符号和说明。
7 .在不同的模块使用内联和非内联的编译选项能够导致 LNK2001 。如果
创建 C ++库时打开了函数内联( /Ob1 或 /Ob2 ),但是在描述该函数的相应头
文件里却关闭了函数内联(没有 inline 关键字),这时将得到该错误信息。
为避免该问题的发生,应该在相应的头文件中用 inline 关键字标志内联函数。
8 .不正确的 /SUBSYSTEM 或 /ENTRY 设置也能导致 LNK2001 。
其实,产生 LNK2001 的原因还有很多,以上的原因只是一部分而已,对初
学者来说这些就够理解一阵子了。但是,分析错误原因的目的是为了避免错
误的发生。 LNK2001 错误虽然比较困难,但是只要注意到了上述问题,还是能
够避免和予以解决的。
编程者来说,最好改的错误莫过于编译错误,而一般说来发生连接错误时,
编译都已通过。产生连接错误的原因非常多,尤其 LNK2001 错误,常常使人不
明其所以然。如果不深入地学习和理解 VC ++,要想改正连接错误 LNK2001 非
常困难。
初学者在学习 VC ++的过程中,遇到的 LNK2001 错误的错误消息主要为:
unresolved external symbol “symbol” (不确定的外部 “ 符号 ” )。
如果连接程序不能在所有的库和目标文件内找到所引用的函数、变量或
标签,将产生此错误消息。一般来说,发生错误的原因有两个:一是所引用
的函数、变量不存在、拼写不正确或者使用错误;其次可能使用了不同版本
的连接库。
以下是可能产生 LNK2001 错误的原因:
一.由于编码错误导致的 LNK2001 。
1 .不相匹配的程序代码或模块定义( .DEF )文件能导致 LNK2001 。例如 ,
如果在 C ++ 源文件内声明了一变量 “var1” ,却试图在另一文件内以变量
“VAR1” 访问该变量 , 将发生该错误。
2 .如果使用的内联函数是在 .CPP 文件内定义的,而不是在头文件内定
义将导致 LNK2001 错误。
3 .调用函数时如果所用的参数类型同函数声明时的类型不符将会产生
LNK2001 。
4 .试图从基类的构造函数或析构函数中调用虚拟函数时将会导致 LNK2001 。
5 .要注意函数和变量的可公用性,只有全局变量、函数是可公用的。
静态函数和静态变量具有相同的使用范围限制。当试图从文件外部访问
任何没有在该文件内声明的静态变量时将导致编译错误或 LNK2001 。
函数内声明的变量(局部变量) 只能在该函数的范围内使用。
C ++ 的全局常量只有静态连接性能。这不同于 C ,如果试图在 C ++的
多个文件内使用全局变量也会产生 LNK2001 错误。一种解决的方法是需要时在
头文件中加入该常量的初始化代码,并在 .CPP 文件中包含该头文件;另一种
方法是使用时给该变量赋以常数。
二.由于编译和链接的设置而造成的 LNK2001
1 .如果编译时使用的是 /NOD ( /NODEFAULTLIB )选项,程序所需要的运行
库和 MFC 库在连接时由编译器写入目标文件模块, 但除非在文件中明确包含
这些库名,否则这些库不会被链接进工程文件。在这种情况下使用 /NOD 将导
致错误 LNK2001 。
2 .如果没有为 wWinMainCRTStartup 设定程序入口,在使用 Unicode 和 MFC
时将得到 “unresolved external on _WinMain@16” 的 LNK2001 错误信息。
3 .使用 /MD 选项编译时 , 既然所有的运行库都被保留在动态链接库之内,
源文件中对 “func” 的引用,在目标文件里即对 “__imp__func” 的引用。
如果试图使用静态库 LIBC.LIB 或 LIBCMT.LIB 进行连接,将在 __imp__func 上发
生 LNK2001 ;如果不使用 /MD 选项编译,在使用 MSVCxx.LIB 连接时也会发生 LNK2001 。
4 .使用 /ML 选项编译时,如用 LIBCMT.LIB 链接会在 _errno 上发生 LNK2001 。
5 .当编译调试版的应用程序时,如果采用发行版模态库进行连接也会产
生 LNK2001 ;同样,使用调试版模态库连接发行版应用程序时也会产生相同的
问题。
6 .不同版本的库和编译器的混合使用也能产生问题,因为新版的库里可
能包含早先的版本没有的符号和说明。
7 .在不同的模块使用内联和非内联的编译选项能够导致 LNK2001 。如果
创建 C ++库时打开了函数内联( /Ob1 或 /Ob2 ),但是在描述该函数的相应头
文件里却关闭了函数内联(没有 inline 关键字),这时将得到该错误信息。
为避免该问题的发生,应该在相应的头文件中用 inline 关键字标志内联函数。
8 .不正确的 /SUBSYSTEM 或 /ENTRY 设置也能导致 LNK2001 。
其实,产生 LNK2001 的原因还有很多,以上的原因只是一部分而已,对初
学者来说这些就够理解一阵子了。但是,分析错误原因的目的是为了避免错
误的发生。 LNK2001 错误虽然比较困难,但是只要注意到了上述问题,还是能
够避免和予以解决的。