자바(Java) 주석(Comment)과 세미콜론(;)

1. 주석(Comment)

1.1 주석이란?

주석은 코드에 대한 설명이나 메모를 추가하는 부분으로, 컴파일러나 JVM이 무시합니다. 즉, 실행에 영향을 미치지 않습니다.

1.2 주석의 종류

자바에서는 세 가지 형태의 주석을 사용할 수 있습니다.

1.2.1 한 줄 주석 (Single-line comment)

• //를 사용하여 한 줄 전체 또는 줄의 일부를 주석 처리합니다.

int age = 20; // 나이를 저장하는 변수

1.2.2 여러 줄 주석 (Multi-line comment)

• /* */로 여러 줄을 감싸서 주석 처리합니다.

/*
이 코드는
사용자의 나이를 저장하고
출력합니다.
*/
int age = 20;
System.out.println(age);

1.2.3 문서 주석 (Javadoc comment)

• /** */ 형식으로 작성되며, 자바 API 문서를 자동으로 생성할 때 사용됩니다.

/**
 * 사용자의 나이를 반환하는 메서드
 * @return 나이 (int)
 */
public int getAge() {
    return age;
}

1.3 주석의 활용 목적

• 코드 설명 및 힌트 제공

• 협업 시 타 개발자와의 커뮤니케이션

• 디버깅을 위해 일시적으로 코드 비활성화

• 문서 자동 생성 (Javadoc)

1.4 주의할 점

• 불필요한 주석은 코드 가독성을 해칠 수 있음

• 자명한 코드에는 주석을 남발하지 말고, 왜 그렇게 작성했는지를 기록하는 것이 더 좋음

---

2. 세미콜론(;)

2.1 세미콜론의 역할

자바에서 세미콜론은 문장의 끝을 나타냅니다. 세미콜론이 없다면 컴파일 에러가 발생합니다.

int x = 10;  // 올바름
int y = 20   // 오류: 세미콜론 누락

2.2 세미콜론을 사용하는 위치

• 변수 선언과 초기화 끝

• 메서드 내부의 실행문 끝

• for 문 안의 초기화, 조건식, 증감식 구분

int sum = 0;

for (int i = 0; i < 10; i++) {
    sum += i;
}

2.3 세미콜론을 사용하지 않는 곳

• 클래스, 메서드, 제어문 블록({}) 정의

• if, for, while 등의 조건 뒤에는 세미콜론을 쓰지 않음

// 잘못된 예시
if (x > 0); {
    System.out.println("양수입니다.");
}
// 위 코드는 if 조건문과 블록이 분리되어 항상 실행됨

2.4 빈 문장으로서의 세미콜론

세미콜론 하나만 있을 경우 **“아무 일도 하지 않는 명령문”**을 의미합니다.

for (int i = 0; i < 10; i++); // 의도치 않은 빈 루프 발생

위와 같은 경우, 루프 본문이 비어 있어서 실제로 반복문이 아무 작업도 하지 않고 실행됩니다. 주의가 필요합니다.

---

결론

구분	주석	세미콜론
기능	코드 설명, 메모	문장의 끝을 구분
컴파일러 처리	무시됨	필수 요소, 누락 시 에러 발생
사용 위치	코드 위, 코드 끝, 메서드 위 등	대부분의 실행 문장 끝
사용 목적	문서화, 협업, 디버깅, 가독성 개선	문법적 완결성 확보