Пространства имён в C++: пошаговая инструкция для новичка

К концу этой инструкции у вас будет собранный проект из двух исходных файлов и заголовка, где одинаково названные функции живут в разных пространствах имён и не конфликтуют друг с другом. На всё уйдёт минут тридцать, если у вас уже установлен компилятор. Код проверялся на GCC 13 и Clang 17 в режиме -std=c++17, но всё описанное работает начиная с C++11, а inline-пространства имён — с C++11 тоже.

Что нужно иметь до начала

• Компилятор с поддержкой C++17: GCC 9+ или Clang 9+, либо MSVC из Visual Studio 2019+. Проверьте версию командой g++ --version или clang++ --version.
• Текстовый редактор или IDE — подойдёт что угодно, от VS Code до CLion.
• Терминал, из которого вы умеете запускать компиляцию. Отдельных прав администратора не требуется.

Отдельно устанавливать ничего для самих пространств имён не нужно: это часть языка, а не библиотека.

Зачем это вообще нужно

Пространство имён¹ — способ сгруппировать имена (функции, классы, переменные), чтобы они не сталкивались с одинаково названными именами из другого кода. Если в вашем проекте есть функция init() и в подключённой библиотеке тоже есть init(), без пространств имён линковщик выдаст ошибку о повторном определении. С ними каждая init() живёт по своему адресу: myapp::init() и vendor::init().

Шаг 1. Объявите первое пространство имён

Создайте файл geometry.hpp и опишите в нём пространство имён с одной функцией:

// geometry.hpp
#pragma once

namespace geometry {
    // Площадь прямоугольника
    double area(double width, double height);
}

Ключевое слово namespace, имя, фигурные скобки — всё, что внутри, теперь принадлежит geometry. После закрывающей скобки точка с запятой не ставится (в отличие от объявления класса).

Проверка: файл должен компилироваться сам по себе командой g++ -std=c++17 -fsyntax-only geometry.hpp без ошибок.

Шаг 2. Определите функцию в отдельном файле

Заголовок содержит только объявление. Реализацию положите в geometry.cpp. Есть два способа привязать определение к пространству имён.

Способ А — снова открыть блок namespace

// geometry.cpp
#include "geometry.hpp"

namespace geometry {
    double area(double width, double height) {
        return width * height;
    }
}

Способ Б — квалифицированное имя

// geometry.cpp
#include "geometry.hpp"

double geometry::area(double width, double height) {
    return width * height;
}

Оба варианта дают одинаковый результат. Способ Б короче, когда функций одна-две; способ А удобнее, когда их много и не хочется писать geometry:: перед каждой.

Проверка: команда g++ -std=c++17 -c geometry.cpp должна создать объектный файл geometry.o без ошибок компоновки.

Шаг 3. Добавьте второе пространство имён с той же функцией

Смысл упражнения — показать, что одинаковые имена мирно сосуществуют. Создайте physics.hpp и physics.cpp:

// physics.hpp
#pragma once

namespace physics {
    // Площадь поверхности сферы
    double area(double radius);
}

// physics.cpp
#include "physics.hpp"

namespace physics {
    double area(double radius) {
        return 4.0 * 3.141592653589793 * radius * radius;
    }
}

Обе функции называются area, но принимают разное число аргументов и живут в разных пространствах. Компилятор различит их без подсказок.

Шаг 4. Используйте оба в main

// main.cpp
#include <iostream>
#include "geometry.hpp"
#include "physics.hpp"

int main() {
    double rect = geometry::area(3.0, 4.0);   // прямоугольник
    double sphere = physics::area(2.0);        // сфера

    std::cout << "Rectangle: " << rect << '\n';
    std::cout << "Sphere:    " << sphere << '\n';
    return 0;
}

Оператор :: явно указывает, какую area вы вызываете. Без него компилятор не понял бы, что имеется в виду.

Шаг 5. Соберите проект

Скомпилируйте три исходника вместе:

g++ -std=c++17 main.cpp geometry.cpp physics.cpp -o demo
./demo

Проверка: в терминале появятся две строки:

Rectangle: 12
Sphere:    50.2655

Если увидели их — пространства имён работают: две функции с именем area собрались в одну программу без конфликта.

Про using: удобно и опасно одновременно

Писать geometry:: каждый раз утомляет. Директива using позволяет обращаться к имени коротко. Есть два варианта, и разница между ними существенная.

• using geometry::area; — вносит в область видимости одно имя. Точечно и безопасно.
• using namespace geometry; — вносит всё содержимое пространства сразу. Быстро приводит к тем самым конфликтам, ради избежания которых пространства и придуманы.

Никогда не пишите using namespace в заголовочном файле. Каждый, кто подключит ваш заголовок, получит это загрязнение к себе, часто не подозревая об этом.

Внутри одной функции в .cpp-файле using namespace допустим — область его действия ограничена этой функцией. В глобальной области файла — уже риск.

Вложенные пространства и короткая запись

Пространства можно вкладывать. С C++17 разрешена компактная запись через двойное двоеточие:

// C++17 и новее
namespace company::product::utils {
    void log();
}

// то же самое, но по-старому (работает везде)
namespace company {
    namespace product {
        namespace utils {
            void log();
        }
    }
}

Обращение: company::product::utils::log(). Если цепочка длинная, заведите псевдоним: namespace cpu = company::product::utils; — и дальше пишите cpu::log().

Если не получилось

Отдельно про безымянное пространство

Если имя нужно спрятать внутри одного файла, а не расшарить, используют безымянный namespace:

// в helper.cpp
namespace {
    int internalCounter = 0;   // видно только в этом файле
}

Это современная замена старому static для функций и переменных на уровне файла. Такое имя не попадёт в другие единицы трансляции даже случайно.

Что делать дальше

Разложите свой реальный проект: заведите одно пространство имён верхнего уровня под весь код проекта (например, по имени продукта), а внутри — по подсистемам. Дальше стоит почитать, чем отличается inline namespace (используется для версионирования API) и как работает поиск имён через аргументы, ADL — из-за него функция иногда находится без квалификатора неожиданным образом. Инвалидация имён при перегрузках и шаблонах — отдельная большая тема, здесь мы её не трогали.

¹ Пространство имён (namespace) — именованная область, объединяющая объявления так, чтобы к ним можно было обращаться через префикс и не пересекаться с именами из другого кода.