managing-global-usings

GlobalUsings.cs로 외부 네임스페이스 중앙 관리

설명

프로젝트 내에서 반복적으로 사용되는 외부 네임스페이스(System.*, NuGet 패키지 등)를 GlobalUsings.cs 파일에 global using으로 선언하여 개별 파일의 using 문을 최소화합니다.

규칙

• 각 프로젝트 루트에 GlobalUsings.cs 파일을 생성합니다
• .NET BCL/FCL 네임스페이스(System.*, Microsoft.* 등)는 global using으로 등록합니다
• NuGet 패키지 네임스페이스(Bogus, Moq, Scalar.AspNetCore 등)는 global using으로 등록합니다
• 솔루션 내부 프로젝트의 네임스페이스(예: CompanyC.Api)는 global using에 등록하지 않습니다
• 개별 파일에서는 GlobalUsings.cs에 등록된 네임스페이스의 using 문을 제거합니다
• 알파벳 순으로 정렬합니다

Worst Case (나쁜 예)

// EmployeeApiTests.cs - 모든 파일마다 동일한 using 반복
using System.Net;
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using Microsoft.AspNetCore.Mvc.Testing;

namespace CompanyC.Api.IntegrationTests;

public class EmployeeApiTests { ... }

// EmployeeBogusTests.cs - 같은 using 또 반복
using System.Net;
using System.Text;
using System.Text.Json;
using CompanyC.Api;
using Microsoft.AspNetCore.Mvc.Testing;

namespace CompanyC.Api.IntegrationTests;

public class EmployeeBogusTests { ... }

Best Case (좋은 예)

// GlobalUsings.cs - 외부 네임스페이스를 한 곳에서 관리
global using System.Net;
global using System.Net.Http.Headers;
global using System.Text;
global using System.Text.Json;
global using Bogus;
global using Microsoft.AspNetCore.Mvc.Testing;
global using Microsoft.Extensions.DependencyInjection;
global using Moq;

// EmployeeApiTests.cs - 외부 using 없이 깔끔
namespace CompanyC.Api.IntegrationTests;

public class EmployeeApiTests { ... }

// EmployeeBogusTests.cs - 내부 네임스페이스만 유지
using CompanyC.Api;

namespace CompanyC.Api.IntegrationTests;

public class EmployeeBogusTests { ... }

적용 대상

• 솔루션 내 모든 프로젝트 (API, 테스트, 도구)
• .NET BCL/FCL 네임스페이스 (System.*, Microsoft.*)
• NuGet 패키지 네임스페이스
• 2개 이상의 파일에서 사용되는 외부 네임스페이스

제외 대상

• 솔루션 내부 프로젝트 네임스페이스 (예: using CompanyC.Api;)
• 단일 파일에서만 사용되는 특수 네임스페이스