c语言subscripted_GCC 常见错误解析

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 及 std::cout 。

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 indeclaration 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

中文含义：非法指令

错误原因：当系统遇到非法的机器指令时，产生此错误。通常此类错误是在源

代码已编译成特定机器的目标代码后，又在其它类型的机器上运行时发生。