В IDE программа собирается по кнопке, а на сервере автопроверки или в терминале у преподавателя её собирает одна строка gcc .... Если не понимать, что в этой строке, ошибки вроде undefined reference или «у меня собирается, у них нет» выглядят как магия. Разберём, что делает компилятор, какие флаги нужны в учебных задачах и как собирать проект из нескольких файлов. Все примеры проверены с gcc 12 в Debian 12. На Mac команда gcc вызывает другой компилятор, об этом в конце.
Одна команда и четыре этапа
gcc main.c -o main
./main
-o main задаёт имя программы. Без него получится a.out (в Windows a.exe). Для C++ то же самое через g++: g++ main.cpp -o main.

За одной командой стоят четыре этапа, и ошибки каждого выглядят по-своему:
- Препроцессор подставляет
#includeи#define. Его ошибка:fatal error: stack.h: No such file or directory. Остановиться после него:gcc -E main.c. - Компиляция переводит C в ассемблер. Здесь синтаксис и типы, сообщения вида
main.c:14:5: error: ...с файлом, строкой и позицией. Посмотреть результат:gcc -S main.c. - Ассемблирование даёт объектный файл
main.o. Остановиться на нём:gcc -c main.c. - Линковка собирает
.oфайлы и библиотеки в программу. Её ошибки приходят отldи заканчиваются строкойcollect2: error: ld returned 1 exit status. Номера строки в них нет, только имя функции.
Уже по виду сообщения понятно, где искать. Есть номер строки: ошибка в коде. Есть ld и undefined reference: код правильный, но собран не тот набор файлов или библиотек.
Предупреждения: -Wall, -Wextra, -Werror
Без флагов gcc молча собирает такой код:
#include <stdio.h>
int main(void) {
int n, sum;
double x;
scanf("%d", &x);
scanf("%d", &n);
if (n = 0)
printf("zero\n");
for (int i = 0; i < n; i++)
sum += i;
printf("%d\n", sum);
return 0;
}
С -Wall -Wextra он находит две ошибки:
$ gcc -Wall -Wextra warn.c -o warn
warn.c:6:13: warning: format ‘%d’ expects argument of type ‘int *’, but argument 2 has type ‘double *’ [-Wformat=]
warn.c:8:9: warning: suggest parentheses around assignment used as truth value [-Wparentheses]
scanf с %d пишет int в переменную типа double, а if (n = 0) присваивает вместо сравнения. Третья ошибка, неинициализированная sum, видна только при сборке с оптимизацией:
$ gcc -Wall -Wextra -O2 warn.c -o warn
...
warn.c:12:5: warning: ‘sum’ is used uninitialized [-Wuninitialized]
Анализ, который находит такие переменные, gcc выполняет вместе с оптимизациями. Поэтому полезно иногда собирать с -O2 только ради предупреждений.
-Werror превращает предупреждения в ошибки, и программа не соберётся, пока они есть. Если в требованиях к заданию есть -Werror, включите его у себя с первого дня, чтобы не разбирать десяток предупреждений в последний вечер.
Стандарт языка: -std
У gcc 12 по умолчанию стандарт C17 с расширениями GNU, у g++ 12 так же C++17 с расширениями. На сервере проверки может стоять другая версия с другим значением по умолчанию, поэтому указывайте стандарт явно, тот, что в условии задачи:
gcc -std=c11 main.c -o main
g++ -std=c++17 main.cpp -o main
Что бывает при несовпадении. Старый стандарт C не разрешает объявлять переменную в заголовке цикла:
$ gcc -std=c89 loop.c -o loop
loop.c:4:5: error: ‘for’ loop initial declarations are only allowed in C99 or C11 mode
А метод contains у std::set появился только в C++20:
$ g++ -std=c++17 contains.cpp -o contains
contains.cpp:6:23: error: ‘class std::set<int>’ has no member named ‘contains’
С -std=c++20 тот же файл собирается и печатает 1.
Отладка и скорость: -g, -O0, -O2
-gдобавляет отладочную информацию: номера строк и имена переменных для gdb, valgrind и санитайзеров. Файл программы становится больше, а на скорость это почти не влияет.-O0(по умолчанию) не оптимизирует. Код выполняется строка за строкой, отладчик показывает всё как написано.-O2оптимизирует, программа работает в разы быстрее. Олимпиадные системы и автопроверки часто собирают с-O2.
Если программа работает с -O0 и ломается с -O2, компилятор почти наверняка ни при чём. В коде неопределённое поведение: выход за массив, неинициализированная переменная, переполнение int. Оптимизатор вправе считать, что такого не бывает. Соберите с -g -fsanitize=address,undefined и запустите: санитайзер покажет строку.
Математика: -lm и порядок аргументов
#include <stdio.h>
#include <math.h>
int main(void) {
double x;
scanf("%lf", &x);
printf("%.3f\n", sqrt(x));
return 0;
}
$ gcc root.c -o root
/usr/bin/ld: /tmp/ccTquok0.o: in function `main':
root.c:(.text+0x20): undefined reference to `sqrt'
collect2: error: ld returned 1 exit status
#include <math.h> только объявляет sqrt. Сама функция лежит в отдельной библиотеке libm, и её нужно подключить флагом -lm. Ставьте его после файлов с кодом: линковщик обрабатывает файлы и библиотеки в том порядке, в каком они написаны (документация GCC). У нас gcc -lm root.c -o root выдал ту же ошибку, а так работает:
$ gcc root.c -o root -lm
$ echo 2 | ./root
1.414
Проект из нескольких файлов
Типичная лабораторная: стек в отдельном модуле. Заголовок stack.h объявляет, что есть в модуле:
#ifndef STACK_H
#define STACK_H
#define STACK_MAX 100
struct stack {
int data[STACK_MAX];
int size;
};
void stack_init(struct stack *s);
int stack_push(struct stack *s, int x);
int stack_pop(struct stack *s, int *x);
#endif
stack.c реализует функции и начинается с #include "stack.h", main.c их вызывает. Собрать можно одной командой, перечислив все .c файлы:
gcc -Wall -Wextra main.c stack.c -o prog
Или по частям: каждый файл в свой .o, потом линковка. Так пересобирается только изменённый файл, на этом построен Makefile:
gcc -Wall -Wextra -c main.c
gcc -Wall -Wextra -c stack.c
gcc main.o stack.o -o prog
Заголовки .h в команду не пишут, их подставляет #include. Если они лежат в отдельной папке, путь к ней передают флагом -I: gcc -Iinclude src/main.c src/stack.c -o prog. Без него будет fatal error: stack.h: No such file or directory.
Include guard и multiple definition
Три строки #ifndef STACK_H, #define STACK_H и #endif называются include guard. Они не дают вставить заголовок в один файл дважды. Это случается чаще, чем кажется: main.c подключает stack.h и calc.h, а calc.h тоже подключает stack.h. Без защиты получится:
In file included from calc.h:4,
from main2.c:3:
stack.h:4:8: error: redefinition of ‘struct stack’
Вместо трёх строк можно написать #pragma once в начале файла. Это не часть стандарта, но gcc, clang и MSVC её понимают.
Include guard защищает только в пределах одного .c файла. Если в заголовке написать определение переменной, например int push_count = 0;, и подключить его в два файла, линковщик найдёт две переменные:
/usr/bin/ld: /tmp/ccf8CEaM.o:(.bss+0x0): multiple definition of `push_count'; /tmp/ccGLz8Mu.o:(.bss+0x0): first defined here
Правило: в заголовке только объявления (extern int push_count;, прототипы функций, структуры, #define), определение в одном .c файле (int push_count = 0;). С функциями так же: тело функции в заголовке даёт ту же ошибку.
undefined reference: проверьте по списку
Ошибка undefined reference to 'имя' значит, что функцию объявили и вызвали, но линковщик не нашёл её код. Причины по частоте:
- Не добавлен
.cфайл с этой функцией.gcc main.c -o progбезstack.cдаётundefined reference to 'stack_init'и такие же строки для остальных функций. - Не подключена библиотека:
-lmдляsqrt,pow,sin;-lpthreadна старых системах для потоков. - Имя в объявлении и определении различается:
stack_pushв заголовке,stackPushв.c. - Функция объявлена, но не написана.
- Код на C++ собран через
gccвместоg++(следующий раздел). undefined reference to 'main': в собранных файлах нет функцииmainили она называетсяMain.
Чем gcc отличается от g++
gcc выбирает язык по расширению файла: .c собирает как C, .cpp как C++. Но при линковке он не подключает стандартную библиотеку C++, а g++ подключает. Поэтому код на C++ через gcc компилируется, но не линкуется:
$ gcc hello.cpp -o hello
/usr/bin/ld: /tmp/cccW3u3j.o: in function `main':
hello.cpp:(.text+0x10): undefined reference to `std::cout'
...
collect2: error: ld returned 1 exit status
Обратная ошибка: g++ считает C++ любой файл, включая .c, а правила там строже. Обычная строка на C перестаёт компилироваться:
$ g++ alloc.c -o alloc
alloc.c:4:20: error: invalid conversion from ‘void*’ to ‘int*’ [-fpermissive]
4 | int *a = malloc(10 * sizeof(int));
Правило простое: C собирайте через gcc, C++ через g++.
На Mac и в Windows
На Mac команда gcc вызывает Apple clang, это видно по gcc --version. Флаги те же, сообщения немного другие: вместо undefined reference пишется, например, Undefined symbols for architecture arm64. Флаг -lm там не нужен, математика входит в системную библиотеку, но и не мешает. Если задание проверяют gcc в Linux, перед отправкой стоит собрать программу именно там.
В Windows gcc ставят через MSYS2 (пакет MinGW-w64) или используют WSL, где это обычный Linux и sudo apt install build-essential ставит gcc, g++ и make.
Команда на каждый день
gcc -std=c11 -Wall -Wextra -Werror -g -O0 main.c stack.c -o prog -lm
g++ -std=c++17 -Wall -Wextra -Werror -g -O0 main.cpp -o prog
Для замера времени замените -g -O0 на -O2. Когда файлов становится больше трёх, переносите эту команду в Makefile.
Как это решает Tilpi
Исполнитель Tilpi собирает и запускает код в отдельной изолированной машине, где стоят gcc, g++, gdb и valgrind, ставит недостающие зависимости и прогоняет тесты. Если сборка падает, он ищет ошибку и предлагает исправление, а ход работы виден в задании. Чат задания пишет и объясняет код, так что можно спросить, что значит конкретное сообщение компилятора. Исполнитель входит во все тарифы: в «Лайт» и «Стандарт» на уровне «Быстрая», в «Плюс» на всех уровнях, а без тарифа работает на «Быстрой» из бесплатных ежемесячных кредитов, общих с чатом.
