g++: сборка C++ из командной строки

Проверка компилятора

g++ — драйвер C++ в наборе GCC: он запускает препроцессор, сам компилятор, ассемблер и линкер, а на этапе линковки добавляет стандартную библиотеку C++. Сначала спросите версию:

g++ --version

g++ (Alpine 15.2.0) 15.2.0 Copyright (C) 2025 Free Software Foundation, Inc. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

На машине без компилятора ответ будет command not found, а в Windows — 'g++' is not recognized as an internal or external command. В Ubuntu и Debian пакет называется g++, а не gcc:

sudo apt install g++

Сборка и запуск одного файла

Сохраните эту программу как hello.cpp. Она печатает две строки:

#include <iostream> #include <vector> #include <string> int main() { std::vector<std::string> langs{"C", "C++"}; for (const auto& lang : langs) { std::cout << "Hello, " << lang << "!\n"; } return 0; }

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

g++ -std=c++23 -Wall -Wextra -Wpedantic hello.cpp -o hello

Запустите файл, который появился в текущем каталоге. Точка и слэш — часть команды: оболочка не ищет программы в текущем каталоге.

./hello

Hello, C! Hello, C++!

Без -o g++ создаёт a.out — то же имя по умолчанию, что и у gcc. Поэтому забытый -o заканчивается свежим a.out рядом с исходниками.

Выбор стандарта

-std= выбирает версию языка. Без него компилятор берёт свой стандарт по умолчанию, а у GCC 15 это gnu++17, поэтому программа с возможностями C++20 или C++23 не соберётся там, где этот флаг не указан. Запишите флаг в скрипт сборки — и один и тот же код собирается везде.

ФлагСтандарт__cplusplus
-std=c++17C++17201703L
-std=c++20C++20202002L
-std=c++23C++23202302L

Макрос показывает, какой стандарт включён. Спросите препроцессор:

g++ -std=c++20 -dM -E -x c++ /dev/null | grep __cplusplus

#define __cplusplus 202002L

Предупреждения

Предупреждение — не ошибка: исполняемый файл всё равно появляется. Прочитайте его, потому что почти каждое предупреждение — настоящая ошибка. В этой программе объявлена и нигде не использована переменная limit:

#include <iostream> int twice(int value) { int result = value * 2; return result; } int main() { int limit = 10; std::cout << twice(21) << '\n'; return 0; }

g++ -std=c++23 -Wall -Wextra warn.cpp -o warn

warn.cpp: In function 'int main()': warn.cpp:11:9: warning: unused variable 'limit' [-Wunused-variable] 11 | int limit = 10; | ^~~~~

В сообщении есть файл, строка и столбец, правило и флаг, которому это правило принадлежит. Чтобы искать одно предупреждение вместо всех, передайте только его флаг, например -Wunused-variable. Чтобы отключить известное предупреждение: -Wno-unused-variable.

Ошибки

Ошибка останавливает сборку, и исполняемый файл не создаётся. Пропущенная точка с запятой — классический случай:

#include <iostream> int main() { std::cout << "one" << '\n' return 0; }

g++ -std=c++23 -Wall broken.cpp -o broken

broken.cpp: In function 'int main()': broken.cpp:5:31: error: expected ';' before 'return' 5 | std::cout << "one" << '\n' | ^ | ; 6 | return 0; | ~~~~~~

Компилятор указывает на строку после настоящей ошибки и даже рисует пропущенный символ. Исправляйте первую ошибку: одна пропущенная точка с запятой часто даёт страницу сообщений следом.

Сообщение линкера выглядит иначе: undefined reference to .... Значит, объявление нашлось, а определение — нет, то есть в командной строке не хватает объектного файла или библиотеки.

Объектные файлы и линковка

-c компилирует и останавливается до линковки: один объектный файл на каждый исходный. Проект из трёх файлов показывает оба шага. Сначала объявление в functions.h:

#pragma once double add(double a, double b);

Затем определение в functions.cpp и вызов в main.cpp:

#include "functions.h" double add(double a, double b) { return a + b; }

#include <iostream> #include "functions.h" int main() { std::cout << add(2, 3) << '\n'; std::cout << add(1.5, 2.5) << '\n'; return 0; }

g++ -std=c++23 -Wall -Wextra -c functions.cpp -o functions.o

ls -l functions.o

-rw-r--r-- 1 user user 1240 Nov 17 19:33 functions.o

В объектном файле лежит машинный код и имена, которых ему не хватает из других файлов. Линковка берёт объектные файлы вместе со стандартной библиотекой C++ и пишет исполняемый файл:

g++ -std=c++23 -Wall -Wextra main.cpp functions.o -o app

./app

5 4

Та же команда с двумя исходниками, g++ main.cpp functions.cpp -o app, делает компиляцию и линковку за один проход. Вариант в два шага быстрее, когда меняется один файл: functions.o остаётся как был.

Разделяемая библиотека

-fPIC -shared собирает разделяемую библиотеку из таких же исходников. Заголовок point.h объявляет distance, point.cpp определяет её, а use.cpp вызывает:

#include "point.h" double distance(double x) { return x < 0 ? -x : x; }

g++ -std=c++23 -fPIC -shared point.cpp -o libpoint.so

-L. добавляет текущий каталог в путь поиска, а -lpoint просит libpoint.so: приставка и расширение — часть имени файла, а не флага.

g++ -std=c++23 use.cpp -L. -lpoint -o use

LD_LIBRARY_PATH=. ./use

3.5

Без LD_LIBRARY_PATH программа запускается и падает с error while loading shared libraries: libpoint.so: cannot open shared object file: линкер записал имя библиотеки, а загрузчику негде её искать.

Оптимизация и отладочная информация

Два флага закрывают большинство сборок. -g пишет отладочную информацию для gdb и санитайзеров, а -O2 просит оптимизатор ускорить код:

g++ -std=c++23 -O2 hello.cpp -o hello_o2

ls -l hello hello_o2

-rwxr-xr-x 1 user user 41344 Nov 17 19:33 hello -rwxr-xr-x 1 user user 19520 Nov 17 19:33 hello_o2

Оптимизированный файл здесь меньше, потому что оптимизатор развернул цикл по вектору из двух строк и напечатал обе строки напрямую. Размеры зависят от кода, компилятора и платформы: сравнивайте свои программы hyperfine, а не читайте слишком много в этой паре.

-O0 — уровень по умолчанию, он совпадает со строками исходника. -O3 добавляет векторизацию. В release-сборке обычно передают -O2 -DNDEBUG.

Санитайзеры

Санитайзер адресов ловит ошибки памяти во время выполнения. Программа ниже выделяет массив и не освобождает его:

#include <iostream> int main() { int* data = new int[4]{1, 2, 3, 4}; std::cout << data[0] << '\n'; return 0; }

g++ -std=c++23 -g -fsanitize=address leak.cpp -o leak

./leak

1 ================================================================= ==355==ERROR: LeakSanitizer: detected memory leaks Direct leak of 16 byte(s) in 1 object(s) allocated from: #0 0x7f8c4ed4374d in operator new[](unsigned long) (/usr/lib/libasan.so.8+0xee74d) #1 0x57c7447ff206 in main leak.cpp:5 #2 0x7f8c4f35a153 in libc_start_main_stage2 src/env/__libc_start_main.c:95 SUMMARY: AddressSanitizer: 16 byte(s) leaked in 1 allocation(s).

Адреса, номер процесса и длинный build id после пути к библиотеке меняются на каждой машине и в каждой сборке; выделение памяти в leak.cpp в строке 5 — нет. -fsanitize=undefined ловит переполнение знаковых чисел, сдвиг на неверную величину и другое неопределённое поведение, -fsanitize=thread — гонки данных. Сборка с санитайзером в два-три раза медленнее, поэтому в продакшн она не идёт.

g++ в make

make берёт компилятор из переменной CXX, которая уже указывает на g++, а флаги — из CXXFLAGS. Файл Makefile для проекта из трёх файлов:

CXX ?= g++ CXXFLAGS ?= -std=c++23 -Wall -Wextra -O2 app: main.o functions.o $(CXX) $(CXXFLAGS) $^ -o $@ %.o: %.cpp functions.h $(CXX) $(CXXFLAGS) -c $< -o $@ clean: rm -f *.o app

make

Дальше проект растёт до CMake: компилятор там определяется сам, а флаги передаются в CMAKE_CXX_FLAGS.

Флаги этой страницы

ФлагЧто делает
-std=c++23Версия языка: 17, 20, 23
-o nameИмя выходного файла
-cСобрать объектный файл, не линковать
-WallПредупреждения, которые нужны всем
-WextraЕщё предупреждения сверх -Wall
-WpedanticПредупреждать о выходе за стандарт
-WerrorСчитать каждое предупреждение ошибкой
-gОтладочная информация для gdb и санитайзеров
-O2Оптимизация, обычный уровень release
-I dirДобавить каталог для #include
-L dirДобавить каталог для библиотек
-l nameСлинковать библиотеку libname.so
-fPIC -sharedСобрать разделяемую библиотеку
-fsanitize=addressПроверка памяти во время выполнения

Все команды этой страницы запускались с g++ 15.2.0 на Alpine Linux 3.24.3 (x86_64) в контейнере Docker.

Автор статьи: Arthur Isaev

Изображение баннера