C# #region 지시문이란? 코드 가독성을 높이는 영역 정리 방법

C#의 #region 지시문은 Visual Studio 코드 편집기의 개요(Outlining) 기능을 사용할 때 확장하거나 축소할 수 있는 코드 블록을 지정하는 전처리기 지시문입니다. 긴 소스 파일에서 관련된 코드들을 논리적으로 그룹화하여 가독성을 크게 향상시킬 수 있습니다.

#region으로 영역을 시작했다면 반드시 #endregion으로 닫아주어야 합니다. 그렇지 않으면 컴파일 오류가 발생합니다.

#region 기본 문법

다음은 #region을 사용하여 코드 영역을 정의하는 기본적인 방법입니다.

#region NewClass definition
public class NewClass {
    static void Main() { }
}
#endregion

#region 지시문 사용 예제

아래 예제는 클래스 선언부, 변수 선언부, 메서드 본문 등 다양한 위치에서 #region 지시문을 활용하는 방법을 보여줍니다.

using System;
#region
class MyClass {
}

#endregion
class Demo {
    #region VARIABLE
    int a;
    #endregion
    static void Main() {
        #region BODY
        Console.WriteLine("region 지시문 사용 예제입니다!");
        #endregion
    }
}

실행 결과

region 지시문 사용 예제입니다!

#region 활용 팁

#region은 주로 다음과 같은 상황에서 유용하게 사용됩니다.

• 큰 클래스 정리: 속성, 필드, 생성자, 메서드 등을 각각의 영역으로 구분하여 코드 탐색을 쉽게 만듭니다.
• 자동 생성 코드 숨기기: 디자이너가 생성한 코드 등 자주 수정하지 않는 부분을 접어두어 핵심 로직에 집중할 수 있습니다.
• 팀 협업: 일관된 영역 구조를 사용하면 여러 개발자가 같은 파일을 작업할 때 코드 구조를 빠르게 파악할 수 있습니다.

다만 #region을 남용하면 오히려 코드 구조를 파악하기 어려워질 수 있으므로, 하나의 클래스나 파일 안에서 적절한 수준으로 사용하는 것이 좋습니다.