Почему следует предпочитать безымянные пространства имен статическим функциям в C++?

Почему безымянные пространства имен лучше? Ключевые преимущества

Вы правы, оба подхода решают одну задачу — ограничение области видимости символов одной единицей трансляции. Однако безымянные пространства имен (namespace {}) обладают рядом фундаментальных преимуществ, которые делают их предпочтительным выбором в современном C++.

1. Работа с типами (ключевое отличие)

static можно применять только к функциям и переменным. Его нельзя использовать для определения локальных типов (классов, структур, перечислений). Безымянное пространство имен не имеет этого ограничения.

// static — НЕ РАБОТАЕТ для типов
// static struct Config { int port; }; // Ошибка компиляции

// unnamed namespace — РАБОТАЕТ
namespace {
    struct Config {
        int port;
        std::string host;
    };

    Config globalConfig {8080, "localhost"};
    
    class InternalHelper {
    public:
        void process(const Config& cfg);
    };
}

2. Единый механизм для всех символов

static имеет разное значение в разных контекстах. Внутри класса — это статический член. Внутри функции — статическая локальная переменная. На глобальном уровне — внутренняя линковка. Безымянное пространство имен всегда означает одно и то же: "этот код доступен только в текущем файле". Это снижает когнитивную нагрузку.

3. Лучшая интеграция с шаблонами

Функции и классы внутри namespace {} могут иметь внешнюю линковку (external linkage), что важно для работы с шаблонами. static функции имеют внутреннюю линковку, что может вызывать проблемы.

// Внутри unnamed namespace — OK
namespace {
    template<typename T>
    void log(const T& value) {
        std::cout << value << std::endl;
    }
}

// static — НЕЛЬЗЯ использовать с шаблонами на глобальном уровне
// static template<typename T> void log(...); // Ошибка

4. Единообразие с C++17 (inline переменные)

Начиная с C++17, у нас есть inline переменные. Если вы объявите inline переменную в заголовочном файле, она будет иметь одинаковый адрес во всех единицах трансляции. В паре с безымянным пространством имен это даёт гибкость, недоступную static.

Когда static всё ещё может быть уместен?

• В C-стиле кода — если вы пишете код, который должен быть совместим с компилятором C (где нет пространств имен).
• Локальные переменные внутри функций — static int counter = 0; внутри функции — это совершенно другая концепция (единственный экземпляр между вызовами), и её нельзя заменить пространством имен.

Итоговый вердикт

Используйте namespace {} для:

• Вспомогательных функций и переменных, нужных только в одном .cpp файле.
• Определения типов (структур, классов, enum), которые не должны быть видны снаружи.
• Любых символов, где вы хотите явно указать "это внутренняя деталь реализации".

Оставьте static для глобальных символов только в коде на чистом C или для обратной совместимости. В современном C++ безымянные пространства имен — это стандарт де-факто, рекомендованный стандартом (C++ Core Guidelines: SF.22).

// Современный C++ подход
// internal_helpers.cpp
namespace { // Весь файл — внутренняя реализация
    void validateInput(int x) {
        if (x < 0) throw std::invalid_argument("...");
    }

    struct CacheEntry {
        int key;
        std::string value;
    };

    std::vector<CacheEntry> cache;
}

void publicAPI(int param) {
    validateInput(param);
    // ... используем cache
}

// file1.cpp
namespace {
    int secret = 42;  // external linkage, но имя искажено
}

// file2.cpp
extern int secret; // Ошибка линковки! Имя secret не найдено

// Если бы было static:
// file1.cpp
static int secret = 42; // internal linkage

// file2.cpp
extern int secret; // Тоже ошибка, но по другой причине