Как скомпилировать программу на C и C++: gcc, g++ и флаги

Компиляция и линковка, проект из нескольких файлов, флаги -Wall, -Werror, -std, -g, -O2 и -lm, ошибка undefined reference и разница между gcc и g++.

В 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.

Бумажный конвейер из четырёх станков: листы с одного края превращаются в маленького робота на другом

За одной командой стоят четыре этапа, и ошибки каждого выглядят по-своему:

  1. Препроцессор подставляет #include и #define. Его ошибка: fatal error: stack.h: No such file or directory. Остановиться после него: gcc -E main.c.
  2. Компиляция переводит C в ассемблер. Здесь синтаксис и типы, сообщения вида main.c:14:5: error: ... с файлом, строкой и позицией. Посмотреть результат: gcc -S main.c.
  3. Ассемблирование даёт объектный файл main.o. Остановиться на нём: gcc -c main.c.
  4. Линковка собирает .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 'имя' значит, что функцию объявили и вызвали, но линковщик не нашёл её код. Причины по частоте:

  1. Не добавлен .c файл с этой функцией. gcc main.c -o prog без stack.c даёт undefined reference to 'stack_init' и такие же строки для остальных функций.
  2. Не подключена библиотека: -lm для sqrt, pow, sin; -lpthread на старых системах для потоков.
  3. Имя в объявлении и определении различается: stack_push в заголовке, stackPush в .c.
  4. Функция объявлена, но не написана.
  5. Код на C++ собран через gcc вместо g++ (следующий раздел).
  6. 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, ставит недостающие зависимости и прогоняет тесты. Если сборка падает, он ищет ошибку и предлагает исправление, а ход работы виден в задании. Чат задания пишет и объясняет код, так что можно спросить, что значит конкретное сообщение компилятора. Исполнитель входит во все тарифы: в «Лайт» и «Стандарт» на уровне «Быстрая», в «Плюс» на всех уровнях, а без тарифа работает на «Быстрой» из бесплатных ежемесячных кредитов, общих с чатом.

Запустим ваш код. Даже с телефона.

ИИ-исполнитель соберёт программу в отдельной машине, запустит её и пришлёт вывод и файлы. Ставить компилятор не нужно.

Собрать и проверить программу в Tilpi