C# 주석(Comment) 완벽 가이드 – 한 줄 주석과 여러 줄 주석 활용법

주석(Comment)은 코드에 설명을 덧붙이기 위해 사용됩니다. 컴파일러는 주석 내용을 완전히 무시하므로 프로그램 실행 결과에는 아무런 영향을 주지 않습니다. C#에서는 크게 두 가지 방식의 주석을 지원하는데, 하나는 여러 줄에 걸쳐 작성할 수 있는 블록 주석이고, 다른 하나는 한 줄짜리 주석입니다.

여러 줄 주석(Multi-line Comment)

여러 줄 주석은 /*로 시작하여 */로 끝납니다. 시작 기호와 종료 기호 사이의 모든 내용은 컴파일러가 무시하며, 몇 줄이든 자유롭게 작성할 수 있습니다.

/* 다음은 C#에서
여러 줄로 작성된 주석입니다 */

/*...*/ 형태의 주석은 컴파일러가 무시하며, 오직 코드에 설명을 추가하기 위한 목적으로만 사용됩니다.

한 줄 주석(Single-line Comment)

한 줄 주석은 //로 시작하며, 해당 기호부터 그 줄의 끝까지가 주석으로 처리됩니다. 간단한 설명이나 임시로 코드 실행을 막고 싶을 때 유용하게 사용됩니다.

// 변수 선언
int a = 10;

다음은 한 줄 주석과 여러 줄 주석을 함께 사용하는 방법을 보여주는 C# 예제 프로그램입니다.

예제

using System;

namespace HelloWorldApplication {
    class HelloWorld {
        static void Main(string[] args) {
            /* 저는 C# 학습을 시작했으며,
            이것은 제 첫 번째 프로그램입니다 */

            // 텍스트 출력
            Console.WriteLine("Learn C# now!");
            Console.ReadKey();
        }
    }
}

실행 결과

Learn C# now!

참고: XML 문서화 주석

C#에는 세 번째 유형의 주석도 존재합니다. ///로 시작하는 XML 문서화 주석으로, 클래스나 메서드 바로 위에 작성하면 Visual Studio의 IntelliSense에서 해당 설명이 표시되고, /doc 옵션으로 컴파일 시 XML 문서 파일을 자동 생성할 수 있어 API 문서화에 매우 유용합니다.

/// <summary>
/// 두 정수를 더하는 메서드입니다.
/// </summary>
int Add(int a, int b) {
    return a + b;
}