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++17 | C++17 | 201703L |
| -std=c++20 | C++20 | 202002L |
| -std=c++23 | C++23 | 202302L |
Макрос показывает, какой стандарт включён. Спросите препроцессор:
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