GCC 常见错误解析
转自：http://wenku.baidu.com/view/01f99435f111f18583d05a47.html
1
GCC 常见错误解析
一、错误类型
第一类∶C 语法错误
错误信息∶文件source.c 中第n 行有语法错误(syntex errror)。
这种类型的错误，一般都是 C 语言的语法错误，应该仔细检查源代码文件中
第n 行及该行之前的程序，有时也需要对该文件所包含的头文件进行检查。
有些情况下，一个很简单的语法错误，gcc 会给出一大堆错误，此时要保持清
醒的头脑，不要被其吓倒，必要的时候再参考一下C 语言的基本教材。
第二类∶头文件错误
错误信息∶找不到头文件head.h(Can not find include file head.h)。
这类错误是源代码文件中的包含头文件有问题，可能的原因有头文件名错误、
指定的头文件所在目录名错误等，也可能是错误地使用了双引号和尖括号。
第三类∶档案库错误
错误信息∶连接程序找不到所需的函数库，例如∶ld: -lm: No such file or
directory.
这类错误是与目标文件相连接的函数库有错误，可能的原因是函数库名错误、
指定的函数库所在目录名称错误等，检查的方法是使用find 命令在可能的目录中寻
找相应的函数库名，确定档案库及目录的名称并修改程序中及编译选项中的名称。
第四类∶未定义符号
错误信息∶有未定义的符号(Undefined symbol)。
这类错误是在连接过程中出现的，可能有两种原因∶一是使用者自己定义的函
数或者全局变量所在源代码文件，没有被编译、连接，或者干脆还没有定义，这需
要使用者根据实际情况修改源程序，给出全局变量或者函数的定义体；二是未定义
的符号是一个标准的库函数，在源程序中使用了该库函数，而连接过程中还没有给
定相应的函数库的名称，或者是该档案库的目录名称有问题，这时需要使用档案库
维护命令ar 检查我们需要的库函数到底位于哪一个函数库中，确定之后，修改gcc
连接选项中的-l 和-L 项。
排除编译、连接过程中的错误，应该说这只是程序设计中最简单、最基本的一
个步骤，可以说只是开了个头。这个过程中的错误，只是我们在使用C 语言描述
一个算法中所产生的错误，是比较容易排除的。我们写一个程序，到编译、连接通
过为止，应该说刚刚开始，程序在运行过程中所出现的问题，是算法设计有问题，
说得更玄点是对问题的认识和理解不够，还需要更加深入地测试、调试和修改。一
个程序，稍为复杂的程序，往往要经过多次的编译、连接和测试、修改。
二、常见错误信息解析与处理
2
1、预处理时的错误信息
No such file or directory
中文含义：没有相应文件或目录
错误原因：编译器的搜索路径上找不到所需要的文件。该文件可能已在命令行
中指定，或在 #include 语句中说明。
处理方法：查看文件名是否正确，或文件所存放的目录是否已添加到系统目录
或链接目录中。以下是样例：
#include
int main (void){
printf ("Hello World!/n");
return 0;
}
上面的程序试图引入一个不存在的文件‘stdoi.h’ ，这就会引发如下错误：
‘stdoi.h: No such file or directory’。而正确的文件名应该是‘stdio.h’。
macro or '#include' recursion too deep
中文含义：宏或'#include' 递归太深
错误原因：语句 #include 嵌套太深。当预处理器遇到太多嵌套的 #include 指
令时，会导致此错误。通常该错误由两个或多个文件进行相互引用时，会引发无限
递归。如：
/* foo.h */
#include "bar.h"
...
/* bar.h */
#include "foo.h"
...
解决方法是确保各文件没有互相引用。
invalid preprocessing directive #...
中文含义：非法的预处理命令#...
错误原因：该错误指明预处理器遇到了不可识别的 # 命令。如：
#if FOO
int x = 1;
#elseif BAR /* 应写成 #elif */
int x = 2;
#else
int x = 3;
#endif
预处理器语法在 #if 块中需要 #elif 而不是 "else if" 条件，也不是
#elseif。
warning: This file includes at least one deprecated or
3
antiquated header.
中文含义：警告：文件中至少引用了一个已废弃的或过时的头文件
错 误 原 因 ： 该 错 误 通 常 是 在 C++ 程序中引用了旧式的头文件库，
如’iostream.h’, 在现代C++库头文件没有’.h’扩展名。旧头文件导入其函数
到顶层全局名字空间，对C++需要使用std:: 名字空间。当然，对旧式风格的头
文件仍然支持，所以对现有程序会继续编译，只是给出警告。如：
#include
int main (void){
cout << "Hello World!/n";
return 0;
}
‘iostream.h’应改写为 #include
unterminated '#if' conditional
中文含义：'#if' 语句条件没有终止
错误原因：缺少 #endif 语句
2、编译时的错误信息
'variable' undeclared (first use in this function)
中文含义：变量'variable' 没有声明（第一次使用此变量）
解决方法：在使用前声明该变量。
解析：在 C 和C++中，变量必须先声明后使用。如：
int main (void){
int i;
j = 0; /* j 变量没声明 */
return j;
}
此例中，j 是没经声明的变量，所以将触发错误：'j' undeclared.
parse error before '...'
中文含义：在 'XXX' 语句前解析错误
错误原因：语法错误
解析：通常是编译器遇到了未期望的输入。如：不合语法的字符串序列。此错
误也可能因为丢失花括号、园括号或分号，或写了非法的保留字而引发。
#include
int main (void){
4
printf ("Hello ") /* 丢失分号 */
printf ("World!/n");
return 0;
}
conflicting types for 'Alex'
中文含义：对 'Alex' 变量存在突出类型
错误原因：前面可能已对 'Alex' 声明了其它数据类型。例如：存在两条语句
分别声明了两次'Alex'变量为两种枚举 (enum) 类型。
two or more data types in declaration specifiers
中文含义：在声明标识符中存在多种数据类型
最容易出现这样的错误，原因是在程序里少了个“；”号。有可能在头文件里，
也有可能在本文件中（最容易出错的是在结构体中忘了“；”）。
too many types in declaration
中文含义：在声明中定义太多的类型
1.是否多次包含着个头文件？检查一下例如：
#ifndef TConfigH
#define TConfigH
#endif //是否少了这个
2.看下将长语句分为多行时,与下一行语句间是否少了逻辑运算符关系,关系运
算符之类的符号
warning: comparison between pointer and integer
中文含义：警告：对指针和整型值进行比较
可能没问题。此警告通常是由'if (strstr(line,"word") != NULL )' 之类的strstr 函
数返回指针或空值。
subscripted value is neither array nor pointer
中文含义：下标值不符合数组或指针要求
错误原因：企图使用可变的变量作为下标
floppyto.c:782: parse error at end of input
中文含义：在文件尾部解析错误
floppyto.c 是程序文件名, 782 是错误行数，但该数字大于文件长度。错误原因：
存在没配对的花括号{}或注解 /* */
#include
int main (void) {
if (1) {
5
printf ("Hello World!/n");
return 0; /* 花括号不匹配 */
}
parse error before 'printf'
中文含义：在'printf' 之前解析错误
错误原因：在该语句之前缺少分号 ';'
warning: implicit declaration of function '...'
中文含义：警告：与函数 XXX 的隐式声明不相符
错误原因：该错误是因为使用的函数没有原型声明而产生。产生的因为可以是
导入错误的头文件，或忘记提供函数原型。如：
int main (void){
printf ("Hello World!/n"); /* 没有头文件 */
return 0;
}
程序中没有导入系统头文件’stdio.h’，所以也就不存在 printf 的原型声
明。改正方法：在程序最前面加入一行语句： #include
unterminated string or character constant
中文含义：未终止的字符串或字符常量
错误原因：该错误是因为使用字符串或字符常量缺少配对的引号而产生。对字
符而言，应使用成对的单引号，而对字符串，应使用成对的双引号。
#include
int main (void){
printf ("Hello World!/n); /* 缺少闭双引号*/
return 0;
}
character constant too long
中文含义：字符常量太长
错误原因：在 C 和C++中，字符常量是由单引号封装起来的单个字符，并且
有相应的ASCII 值。如 'a' 对应的ASCII 为67, 而 '/n' 对应的ASCII 为10。本错
误是因为使用单引号封装了多于一个字符而引发。如：
#include
int main (void){
printf ('Hello World!/n'); /* 错误的封装 */
return 0;
}
多字符组成的是字符串，应用双引号封装。对上例，应改写成： "Hello World!"。
6
warning: initialization makes integer from pointer without a
cast
中文含义：警告：初始化过程中不能从指针到整型数进行转换
错误原因：该错误指示在整型数环境中误用了指针。从技术上，可以在指针和
整型数之间相互转换，但这很少用在外部系统级应用程序中。通常，此类警告是在
使用了指针而没有释放该指针而引发。（如语句写成int i = p 而不是int i =
*p，其中p 是指针）。该警告在类型char 和char *之间转换时也可能引发，因
为char 也是整数类型。
int main (void){
char c = "/n"; /* 不正确 */
return 0;
}
变量 c 是 char 类型，而 "/n" 是字符串且会被系统认为是 const char * 指针
(将占用 2-字节内存，包括 '/0'，因为字符串没有终止符)。类似的错误也会发生在
对宏 NULL 的误用：
#include
int main (void){
int i = NULL; /* 不正确 */
return 0;
}
在C 的‘stdlib.h’中，宏 NULL 被定义为 ((void *)0) ，它只能用在指针环境中。
dereferencing pointer to incomplete type
中文含义：间接引用指针为不合适的类型
错误原因：程序试图通过指针访问一个没有事先声明的结构体内元素。在C
和C++中，在声明指向结构的指针时，应先声明结构体。
struct btree * data;
int main (void){
data->size = 0; /* 不合适的类型 */
return 0;
}
此程序使用 btree 结构 data 的前向声明。然而，在指针间接独立访问内存前，
需要定义该结构。
warning: unknown escape sequence '...'
中文含义：警告：未知的转义序列
错误原因：使用了不正确的转义字符。合法的转义字符序列如下：
/n 新行 /t 制表符
/b 回退 /r 回车
/f 换页 /v 垂直制表
7
/a 警告 (铃声)
组合字符 //, /', /" 和 /? 表示相应的独立字符。转义序列也可用八进制码
/0--/377 和十六进制码 /0x00--/0xFF 来表示。
#include
int main (void){
printf ("HELLO WORLD!/N"); /* /N 错误 */
return 0;
}
warning: suggest parentheses around assignment used as truth
value
中文含义：警告：建议用圆括号括上用于逻辑值的赋值表达式
错误原因：该警告强调潜在的语义错误，程序在条件语句或其它逻辑表达式测
试中使用了赋值操作符 ‘=’ 而不是比较操作符 ‘= =’ 。当然在语法上，赋值操作符
可作为逻辑值使用，但在实践中很少用。
#include
int main (void){
int i = 0;
if (i = 1) { /* = 应该是 == */
printf ("unexpected result/n");
}
return 0;
}
warning: control reaches end of non-void function
中文含义：警告：控制到达非void 函数末端。
错误原因：若一个函数已声明为有返回数据类型（如int 或double），那么就必
须在函数中的适当位置（所有可能的结束点）使用return 语句返回相应类型的值。
否则，就属于不是良好定义的函数。若函数声明为void，则不需要return 语句。
#include
int display (const char * str){
printf ("%s/n", str);
}
以上程序在 display 函数的尾部没有返回语句，但它又声明为返回 int 类
型。可以通过添加 return 0; 之类的语句加以解决。当使用 gcc 时，C 程序中
的 main 函数必须返回一个 int 型数据(用于表明程序的退出状态)。
warning: unused variable '...'
中文含义：警告：存在从未使用的变量 XXX。
warning: unused parameter '...'
中文含义：警告：存在从未使用的参数 XXX。
8
错误原因：该警告指示存在已声明为局部的变量或函数参数，但在其它地方并
没使用过它。没使用过的变量可能会导致程序性错误，如偶尔在预期的位置上写了
不同的变量名。
int foo (int k, char * p){
int i, j;
j = k;
return j;
}
在本程序中，变量 i 和参数 p 从没使用过。
warning: passing arg of ... as ... due to prototype
中文含义：警告：传送 XX 参数为XXX，但原型不匹配。
错误原因：该警告指示在调用函数时，存在与声明的参数类型原型不一致的情
况。
warning: passing arg 1 of 'cpystr' makes integer from pointer
中文含义：警告：函数的参数1 存在参数不匹配，即无法进行类型转换
错误原因：类型转换不匹配
下面的样例就存在这方面的问题:
void cpystr( char item);
main(){
char src[]="martin leslie";
cpystr(src);
}
cpystr(char item){ }
函数应该写成如下类似的格式：
void cpystr( char item[]);
main(){
char src[]="martin leslie";
cpystr(src);
}
cpystr(char item[]){ }
warning: assignment of read-only location
中文含义：警告：对只读变量进行赋值。
错误原因：检查赋值的变量是否已用 const 修饰或已被声明为常量。
warning: cast discards qualifiers from pointer target type
中文含义：警告：在指针目标类型中存在不合适的转换限定符。
9
warning: assignment discards qualifiers ...
中文含义：警告：赋值丢弃限定符 XXX。
warning: initialization discards qualifiers ...
中文含义：警告：初始化丢弃限定符 XXX。
warning: return discards qualifiers ...
中文含义：警告：返回值丢弃限定符 XXX。
错误原因：对指针的不正确使用了违法的限定符。检查赋值的变量是否已用
const 修饰或已被声明为常量。若指针被限制为 const 则该指针不能被修改，且
只能被用于向其它指针赋值。
char *f (const char *s){
*s = '/0'; /* 向只读数据赋值 */
return s; /* 将会丢弃常量，即并不能被返回 */
}
该程序试图修改常量数据，并在返回值中使用常量属性参数而导致丢弃。
initializer element is not a constant
中文含义：初始化元素不是常量。
错误原因：在C 中，全局变量只能在初始化是赋值常量，如数值、NULL 或字
符串常量。若使用了非常量值则会引发此错误。
#include
FILE *stream = stdout; /* 不是常量 */
int i = 10;
int j = 2 * i; /* 不是常量 */
int main (void){
fprintf (stream, "Hello World!/n");
return 0;
}
注意：在C++中则允许在初始化中使用非常量数据。
3、链接时的错误信息
file not recognized: File format not recognized
中文含义：文件不可识别：文件格式不可识别。
错误原因：文件扩展名不是 ‘.c’。
#include
int main (void){
printf ("Hello World!/n");
return 0;
}
若上述文件保存为 ‘hello’ 但没有扩展名，则编译时会给出如下错误：
10
$ gcc -Wall hello
hello: file not recognized: File format not
recognized
collect2: ld returned 1 exit status
解决方案是将文件重命名为带合适的扩展名。对本例可重命名为 ‘hello.c’.
undefined reference to 'foo'
collect2: ld returned 1 exit status
中文含义：没定义对'foo' 的引用。
错误原因：程序中使用了在本文件和其它库中没有定义的函数或变量。有可
能是丢失了链接库，或使用了不正确的名字。
在此例中，’collect2’ 是链接程序的一部分。
int foo(void);
int main (void){
foo();
return 0;
}
/usr/lib/crt1.o(.text+0x18): undefined reference to 'main'
中文含义：没定义对main 函数的引用
错误原因：程序中缺少 main()函数。
/usr/lib/crt0.o: Undefined symbol _main referenced from text
segment
中文含义：从文本段引用没定义的_main 符号
错误原因：缺少 main()函数—但实际上有，为什么？
1.在头文件中可能存在语法错误；
2.在C 源文件中可能缺少gcc 命令
Undefined symbol _initscr referenced from text segment
中文含义：从文本段引用没定义的_initscr 符号
错误原因：调用了一个函数，但并没有该函数，或在#include 语句中没有包含
该函数的库。
4、运行时的错误信息
error while loading shared libraries:
cannot open shared object file: No such file or directory
中文含义：装载共享库是出错：
不能打开共享对象文件：不存在该文件或目录
11
错误原因：程序中使用了共享库，但程序启动时通过动态链接找不到所需的共
享库文件。如果确定存在，则请修改共享类库搜索路径变量值LD_LIBRARY_PATH。
Segmentation fault
中文含义：分段错误，总线错误
错误原因：企图访问受保护的内容或覆盖重要的数据! 它指明内存访问错误。
通常的原因如下：
1、反向引用一个空指针或没初始化的指针；
2、超出数组访问的下标；
3、对 malloc, free 和相关函数不正确的使用；
4、使用 scanf 时的参数（数量、类型）不正确。
floating point exception
中文含义：浮点运算异常
错误原因：这是个算术运算异常。如除数为0，上溢、下溢或非法的操作（如
对-1 求平方根）。
Illegal instruction
中文含义：非法指令
错误原因：当系统遇到非法的机器指令时，产生此错误。通常此类错误是在源
代码已编译成特定机器的目标代码后，又在其它类型的机器上运行时发生。