Директивы using внутри или снаружи пространства имен в C#: какой вариант правильный?

Ключевое различие: область видимости директив using

Разница между размещением директив using внутри или снаружи пространства имен действительно существует, и она связана с областью видимости этих директив. Давайте разберем оба подхода на конкретных примерах.

Вариант 1: Директивы снаружи namespace (глобальная область)

using System;
using System.Collections.Generic;

namespace MyApp
{
    class Program { }
}

namespace MyApp.Legacy
{
    class OldProgram { }
}

В этом случае using System применяется ко всем пространствам имен в файле. Оба класса — Program и OldProgram — видят типы из System. Это поведение интуитивно понятно: вы импортируете пространство имен для всего файла.

Вариант 2: Директивы внутри namespace (локальная область)

namespace MyApp
{
    using System;
    using System.Collections.Generic;
    
    class Program { }
}

namespace MyApp.Legacy
{
    // Здесь using System НЕ ДЕЙСТВУЕТ!
    class OldProgram 
    {
        // Ошибка: тип List<T> не найден
        private List<int> _items; 
    }
}

Директивы using, расположенные внутри namespace, действуют только в пределах этого конкретного пространства имен. Для MyApp.Legacy они не видны. Это может привести к неожиданным ошибкам компиляции, если вы добавите новое пространство имен в файл.

Что говорит StyleCop и почему?

Правило SA1200: UsingDirectivesMustBePlacedWithinNamespace рекомендует размещать using внутри namespace. Основные аргументы:

• Изоляция конфликтов имен: Если вы используете библиотеки с одинаковыми именами типов (например, своя версия List), размещение using внутри namespace защищает другие части файла от случайного импорта.
• Явная зависимость: Каждое пространство имен четко указывает, от каких библиотек оно зависит. Это улучшает читаемость больших файлов.
• Совместимость с глобальными using (C# 10+): В современных проектах часто используют global using для общих зависимостей, а локальные using внутри namespace — для специфичных.

Практические рекомендации

Вот как я советую поступать в реальных проектах:

1. Для новых проектов (.NET 6+ и C# 10+) используйте global using в отдельном файле (например, GlobalUsings.cs) для самых частых пространств имен, а специфичные using размещайте внутри namespace.
2. Для старых проектов (.NET Framework) придерживайтесь единого стиля. Если команда использует StyleCop — следуйте правилу SA1200. Если нет — можете размещать снаружи, это не критично.
3. Главное правило: Будьте последовательны. Если в проекте принято писать using внутри namespace — делайте так везде. Если снаружи — тоже везде.

В итоге: оба варианта работают, но размещение внутри namespace дает больше контроля над областью видимости и считается более современным подходом, особенно с появлением глобальных using.