C Erros Comuns

Quando algo dá errado, o C fala inglês, em frases curtas e às vezes misteriosas. Esta página junta as mensagens que você mais vai ver, em três momentos: na compilação (o gcc), na ligação (o ld) e na execução (o seu programa caindo). Cada uma vem com o que ela quer dizer, como consertar e a aula onde o assunto é explicado. Todas foram provocadas de verdade.

Atalhos: Ler uma mensagem · Compilação, ligação ou execução? · Erros de compilação · Avisos · Erros de ligação · Erros do terminal · Erros de execução · Códigos de saída · Experimente

Como ler uma mensagem do gcc

#include <stdio.h>

int main(void) {
    int idade = 29;
    printf("%d\n", idad);
    return 0;
}

$ gcc -std=c23 -Wall -Wextra e01.c -o e01
e01.c: In function ‘main’:
e01.c:5:20: error: ‘idad’ undeclared (first use in this function); did you mean ‘idade’?
    5 |     printf("%d\n", idad);
      |                    ^~~~
      |                    idade
e01.c:5:20: note: each undeclared identifier is reported only once for each function it appears in
e01.c:4:9: warning: unused variable ‘idade’ [-Wunused-variable]
    4 |     int idade = 29;
      |         ^~~~~

Conserte sempre o primeiro erro primeiro. Um erro costuma provocar outros em cascata: aqui, o aviso unused variable ‘idade’ só existe por causa do erro de digitação. E o erro de verdade pode estar antes da linha apontada (um ; que faltou na linha de cima, por exemplo). Aula: Lendo Erros do Compilador.

Compilação, ligação ou execução?

Erros de compilação

Cada linha desta tabela é um programa pequeno, provocado de propósito. A coluna do gcc mostra só o texto principal (sem arquivo:linha:coluna).

Avisos (warning)

Um aviso não impede o programa de ser criado, mas quase sempre aponta um bug. Compile sempre com -Wall -Wextra, e trate cada aviso como erro (a opção -Werror faz isso de verdade). Este programa junta os avisos mais comuns:

#include <stdio.h>

int maior(int a, int b) {
    if (a > b) {
        return a;
    }
}

int *criar(void) {
    int local = 7;
    return &local;
}

int main(int argc, char *argv[]) {
    int sobra;
    int x;
    printf("%d\n", x);
    x == 5;
    if (x > 5);
    {
        printf("maior\n");
    }
    int opcao = 1;
    switch (opcao) {
        case 1:
            printf("um\n");
        case 2:
            printf("dois\n");
            break;
    }
    if (x > 0)
        printf("a\n");
        printf("b\n");
    printf("%d %p\n", maior(1, 2), (void *)criar());
    return 0;
}

Erros de ligação (o ld)

O compilador transforma cada .c num arquivo-objeto (.o); o ligador junta tudo, com as bibliotecas, num executável. Os erros dele não têm número de linha e terminam sempre com collect2: error: ld returned 1 exit status ("o ld terminou com o código 1"). Aula: Como o C Vira Programa.

$ gcc -std=c23 -Wall -Wextra l01.c -o l01               « l01.c declara int soma(int a, int b); mas não a define
/usr/bin/x86_64-linux-gnu-ld.bfd: /tmp/ccOoraNE.o: na função "main":
l01.c:(.text+0x13): referência não definida para "soma"
collect2: error: ld returned 1 exit status
$ gcc -std=c23 -Wall -Wextra l02.c -o l02               « escreveu int Main(void)
/usr/bin/x86_64-linux-gnu-ld.bfd: /usr/lib/gcc/x86_64-linux-gnu/15/../../../x86_64-linux-gnu/Scrt1.o: na função "_start":
(.text+0x1b): referência não definida para "main"
collect2: error: ld returned 1 exit status
$ gcc -std=c23 -Wall -Wextra l03.c -o l03               « usa sqrt(x) do math.h
/usr/bin/x86_64-linux-gnu-ld.bfd: /tmp/ccezM8a9.o: na função "main":
l03.c:(.text+0x23): referência não definida para "sqrt"
collect2: error: ld returned 1 exit status
$ gcc -std=c23 -Wall -Wextra l03.c -o l03 -lm
$ ./l03
1.414
$ gcc -std=c23 -Wall -Wextra l04a.c l04b.c -o l04       « os dois arquivos têm int contador = 0;
/usr/bin/x86_64-linux-gnu-ld.bfd: /tmp/ccWgCA1M.o:(.bss+0x0): múltiplas definições de "contador"; /tmp/cc7vaz22.o:(.bss+0x0): definido primeiro aqui
collect2: error: ld returned 1 exit status
$ gcc -std=c23 -Wall -Wextra l01.c -o l01 -lfoo
/usr/bin/x86_64-linux-gnu-ld.bfd: não foi possível localizar -lfoo: Arquivo ou diretório inexistente
collect2: error: ld returned 1 exit status

Outras mensagens do gcc

$ gcc -std=c23 -Wall -Wextra nao-existe.c -o x
cc1: fatal error: nao-existe.c: Arquivo ou diretório inexistente
compilation terminated.
$ gcc
gcc: fatal error: no input files
compilation terminated.

O arquivo não está nesta pasta (confira com ls e pwd) ou o nome está errado; e o gcc precisa de pelo menos um arquivo. Aula: Compilar com gcc.

Erros do terminal (o bash)

$ ./e01                                                  « o e01.c tinha erro: o programa não foi criado
bash: ./e01: Arquivo ou diretório inexistente
$ ./l03                                                  « o arquivo perdeu a permissão de execução
bash: ./l03: Permissão negada
$ ola                                                    « faltou o ./
bash: ola: comando não encontrado

Erros de execução

O programa compilou, começou a rodar e caiu. Aqui, a mensagem vem do sistema ou da biblioteca C, sem número de linha. Para achar a linha, use o gdb, os sanitizers (-fsanitize=address) ou o Valgrind. As saídas abaixo são do terminal da Ana (-t, terminal de verdade):

$ ./r1                                                   « int *p = NULL; *p = 5;
Vou escrever no endereço nulo...
Falha de segmentação     (imagem do núcleo gravada) ./r1
$ echo "código: $?"
código: 139
$ ./r3                                                   « assert(estoque >= 0); com estoque = -2
r3: r3.c:6: main: Assertion `estoque >= 0' failed.
Abortado                   (imagem do núcleo gravada) ./r3
$ ./r4                                                   « free(v); free(v);
free(): double free detected in tcache 2
Abortado                   (imagem do núcleo gravada) ./r4
$ ./r6                                                   « free num array que não veio do malloc
free(): invalid pointer
Abortado                   (imagem do núcleo gravada) ./r6
$ ./r7                                                   « recursão sem fim
Falha de segmentação     (imagem do núcleo gravada) ./r7
$ echo AnaSouzaDaSilva | ./r5                            « scanf("%s", nome) num char nome[8]
Nome: Olá, AnaSouzaDaSilva!
*** stack smashing detected ***: terminated
Abortado                   (imagem do núcleo gravada) echo AnaSouzaDaSilva | ./r5

Códigos de saída

Todo programa termina com um número, que o terminal guarda em $? (echo $? mostra) e que o editor mostra como [código de saída: N]. Acima de 128, é 128 + o número do sinal que matou o programa. Aula: exit e atexit.

Experimente

#include <stdio.h>

int main(void) {
    int canetas = 3
    int cadernos = 2;
    int total = canetas * 4 + cadernos * 9;
    printf("Total: R$ %d\n", totl);
    return 0;
}

#include <stdio.h>

int main(void) {
    int canetas = 3;
    int cadernos = 2;
    int total = canetas * 4 + cadernos * 9;
    printf("Total: R$ %d\n", total);
    return 0;
}

Resumo

• Compilação (arquivo:linha:coluna: error:): conserte o primeiro erro primeiro e olhe também a linha de cima. Os mais comuns: undeclared, expected ‘;’, implicit declaration, aspas e chaves sem par.
• Avisos (warning:): quase sempre são bugs. Compile com -Wall -Wextra e deixe zero avisos.
• Ligação (referência não definida para, collect2: error: ld returned 1 exit status): falta uma função, o main, um .c no comando ou o -lm.
• Execução: Falha de segmentação (139), Abortado (134: assert, double free, stack smashing), Exceção de ponto flutuante (136). Ache a linha com gdb ou -fsanitize=address.
• No editor, as mensagens são do Clang, e muitos erros de memória passam calados: confira no gcc.