[Java] 주석(/, /*, /**)과 공백, 식별자와 예약어

1. 주석 (Comment)

• 주석은 코드에 설명을 달아두는 메모
• 프로그램 실행에는 전혀 영향을 주지 않으며, 코드의 이해도와 유지보수성을 높여줌.

1)  한 줄 주석 (//)

System.out.println("Hello world"); // 한 줄 주석입니다.

• // 뒤부터 줄 끝까지 주석 처리됨.
• 이클립스 단축키: Ctrl + /

 

2) 여러 줄 주석 (/* ... */)

/*
 * 여러 줄에 걸쳐 작성하는 주석입니다.
 */

• 이클립스 단축키: 입력 Ctrl+Shift+/, 해제 Ctrl+Shift+\

 

3) Document 생성 주석 (/** ... */)

/**
 * API Document를 생성하기 위한 주석입니다.
 * @author jinkyoung
 * @version 1.0
 * @since 2023.03.07
 */

• javadoc 명령어로 HTML API 문서를 자동 생성.
• 클래스, 메서드, 변수의 선언부 바로 위에 위치.
• 이클립스 단축키: Shift+Alt+J

 /**와 */ 사이의 *는 가독성을 위한 관례적 표현.

 

2. 세미콜론, 블록, 공백

1) 세미콜론 (;)

• 논리적인 한 문장이 끝날 때 반드시 붙여야함.
• 한 줄에 여러 문장을 작성할 수 있지만, 각 문장마다 ;이 필요.

 

int a = 10; int b = 20; int c = 30;

 

2) 블록 { }

• 중괄호로 감싸인 영역으로, 여러 문장을 하나의 단위로 묶음.
• 클래스, 메서드에는 반드시 한 쌍의 중괄호가 있어야 함.

 

class SomeClass {
    {
        ...
    }
}

구글 자바 스타일 가이드에서는 '{' 를 선언 문장 맨 뒤에 붙이는 방식을 권장

 

3) 공백 (Whitespace)

• 빈칸, 탭, 빈 줄 등이 해당.
• 이클립스 전체 자동 들여쓰기: Ctrl+A → Ctrl+I

 

3. 식별자 (Identifier)

• 클래스 명, 메서드 명, 변수명 등 사용자가 직접 붙이는 고유한 이름.

규칙	내용
대·소문자 구분	Name과 name은 서로 다른 식별자
사용 가능 문자	문자, 숫자, _, $
시작 문자	숫자 시작 불가 (문자, _, $는 가능)
공백	포함 불가
예약어	식별자로 사용 불가

 

1) ❌ 잘못된 예

예시	이유
3test	숫자로 시작 불가
@test	_, $ 외 특수문자 불가
this	예약어 사용 불가
num data	공백 포함 불가

 

2) ✅ 올바른 예

예시	설명
test3	숫자는 첫 문자만 아니면 가능
_test	_는 첫 문자로 사용 가능
This	this와 대소문자가 달라 유효
numData	카멜케이스 사용 가능

 

4. 예약어 (Reserved Words)

• 자바 언어에서 미리 정의된 단어
• 키워드(Keyword)라고도 함.
• 예약어는 식별자로 사용할 수 없음.
• 자바 예약어 목록 (알파벳 순)

abstract	continue	for	new	switch
assert	default	goto*	package	synchronized
boolean	do	if	private	this
break	double	implements	protected	throw
byte	else	import	public	throws
case	enum	instanceof	return	transient
catch	extends	int	short	try
char	final	interface	static	void
class	finally	long	strictfp	volatile
const*	float	native	super	while

⚠️ goto와 const는 예약되어 있지만 실제로는 사용하지 않음.

 

⚠️ 리터럴 주의사항
- true, false, null은 예약어는 아니지만 식별자로 사용할 수 없으며, 반드시 소문자로 입력해야 함.