본문 바로가기
코딩 이야기/자바 코딩

[자바 기초] 초보자를 위한 Java 기본 구문 완벽 가이드: 주석 달기부터 코드 구조까지

by 안개소리 2026. 4. 1.

[자바 기초] 초보자를 위한 Java 기본 구문 완벽 가이드: 주석 달기부터 코드 구조까지

서론: 왜 자바(Java)의 기본 구문부터 확실히 잡아야 할까요?

프로그래밍을 처음 시작할 때, 많은 분들이 화려한 결과물을 빨리 만들고 싶은 마음에 기본기를 건너뛰곤 합니다. 하지만 자바(Java)와 같은 견고한 언어에서는 '기본 구문(Syntax)'과 '주석(Comments)'을 제대로 이해하는 것이 튼튼한 집을 짓기 위한 기초 공사와 같습니다. 코드는 컴퓨터에게 내리는 명령이기도 하지만, 미래의 나 자신 그리고 동료 개발자와 소통하는 언어이기도 합니다. 오늘은 자바 코딩을 시작하는 분들을 위해 가장 필수적인 기본 구문과 올바른 주석 작성법을 깊이 있게 파헤쳐 보겠습니다.

1. 자바 프로그램의 뼈대: 클래스와 메인 메서드

자바는 객체 지향 언어(OOP)로, 모든 코드는 반드시 '클래스(Class)' 안에 작성되어야 합니다. 또한 프로그램이 실행되기 위해서는 진입점 역할을 하는 '메인 메서드(Main Method)'가 필수적입니다.

  • 클래스 선언: 자바의 기본 단위입니다. 파일 이름과 클래스 이름은 반드시 동일해야 하며 대문자로 시작합니다.
  • 메인 메서드: public static void main(String[] args) 이 주문 같은 문장은 자바 프로그램이 시작되는 출발점입니다. 프로그램이 실행되면 JVM(자바 가상 머신)은 가장 먼저 이 부분을 찾습니다.
  • 세미콜론(;): 자바에서 하나의 명령(문장)이 끝났음을 알리는 마침표 역할을 합니다. 누락하면 컴파일 에러가 발생합니다.

2. 코드의 친절한 안내서: 주석(Comments)의 종류와 활용

주석은 프로그램의 실행에는 전혀 영향을 주지 않지만, 코드를 설명하거나 특정 로직을 잠시 실행하지 않도록 막아둘 때 사용하는 매우 중요한 요소입니다. 자바에서는 세 가지 형태의 주석을 지원합니다.

// 1. 한 줄 주석: 슬래시 두 개를 사용하며 해당 줄 끝까지 적용됩니다.
int score = 100; // 점수를 저장하는 변수

/*
  2. 여러 줄 주석:
  긴 설명을 작성하거나 코드 여러 줄을 무시할 때 사용합니다.
*/


/**
 * 3. JavaDoc 주석:
 * 공식 API 문서를 자동으로 생성할 때 사용되는 특별한 주석입니다.
 * @author 홍길동
 */

3. 데이터를 담는 그릇: 변수와 자료형(Data Types)

기본 구문을 익힐 때 빠질 수 없는 것이 변수입니다. 자바는 정적 타입(Statically typed) 언어이므로, 변수 선언 시 '어떤 종류의 데이터'를 담을지 명시해야 합니다.

  • 정수형 (int): 나이, 수량 등 소수점이 없는 숫자를 저장합니다. (예: int age = 25;)
  • 실수형 (double): 키, 환율 등 소수점이 포함된 정밀한 숫자를 저장합니다. (예: double height = 175.5;)
  • 문자열 (String): 텍스트 데이터를 저장할 때 사용하며, 반드시 큰따옴표("")로 감싸야 합니다. (예: String name = "자바";)
  • 논리형 (boolean): 참(true) 또는 거짓(false) 단 두 가지의 값만 가질 수 있습니다.

4. 컴퓨터와 대화하기: 기본 출력문

내가 작성한 코드의 결과를 화면(콘솔)으로 확인하려면 자바의 대표적인 System.out 객체를 활용한 출력문 구문을 알아야 합니다.

  • print(): 괄호 안의 내용을 출력하고 줄 바꿈을 하지 않습니다.
  • println(): 내용을 출력한 뒤 자동으로 한 줄을 띄워주는(Line break) 가장 자주 쓰이는 구문입니다.
  • printf(): C언어처럼 포맷을 지정하여 출력할 때 사용합니다. %d(정수), %s(문자열) 등을 활용해 깔끔하게 정렬할 수 있습니다.

5. 좋은 코드를 위한 첫걸음: 네이밍 규칙(Naming Conventions)

자바 문법상 오류는 아니더라도, 전 세계 개발자들이 암묵적으로 지키는 이름 짓기 규칙이 있습니다. 협업을 위해 반드시 습관화해야 합니다.

  • 클래스 이름: 항상 대문자로 시작하며, 단어마다 첫 글자를 대문자로 적습니다. (PascalCase)
  • 메서드 및 변수 이름: 소문자로 시작하되, 연결되는 단어의 첫 글자는 대문자로 적습니다. (camelCase)
  • 상수 이름: 변하지 않는 값은 모두 대문자로 적고 언더스코어(_)로 구분합니다. (예: MAX_CAPACITY)

💡 자주 묻는 질문 (FAQ)

Q1. 주석을 너무 많이 달면 프로그램 용량이 커지거나 실행 속도가 느려지나요?
A. 전혀 그렇지 않습니다! 자바 코드를 컴퓨터가 이해할 수 있는 언어(바이트코드)로 변환하는 '컴파일' 과정에서 주석은 모두 무시되고 삭제됩니다. 따라서 주석의 양은 프로그램의 성능이나 최종 파일 크기에 아무런 영향을 미치지 않으니 안심하고 상세히 작성하셔도 됩니다.
Q2. 자바 코딩 시 대소문자를 실수로 다르게 적으면 어떻게 되나요?
A. 자바는 대소문자를 엄격하게 구분(Case-sensitive)하는 언어입니다. 예를 들어 Stringstring으로 적거나, 변수 myAgeMyAge로 호출하면 컴파일 에러가 발생하여 프로그램이 실행되지 않습니다. 항상 대소문자 작성에 주의해야 합니다.
Q3. 코드 끝에 세미콜론(;)을 자꾸 빼먹는데, 팁이 있을까요?
A. 초보자 시절 누구나 겪는 자연스러운 과정입니다! 한국어에서 문장이 끝나면 마침표를 찍듯, 자바에서는 세미콜론(;)이 문장의 끝을 의미한다고 의식적으로 생각해보세요. 인텔리제이(IntelliJ) 같은 최신 IDE 도구를 사용하면 누락 시 즉각 경고를 해주므로 툴의 도움을 받는 것도 좋습니다.

📝 한눈에 보는 요약

  • 자바의 기초는 클래스와 메인 메서드로 이루어진 기본 구조를 이해하는 것에서 출발합니다.
  • 주석(//, /* */, /** */)은 성능 저하 없이 코드의 가독성을 높여주는 핵심 소통 도구입니다.
  • 올바른 자료형 선언과 네이밍 규칙(camelCase 등)을 습관화하면 전문가다운 깔끔한 코드를 작성할 수 있습니다.