티스토리 뷰

몸부림의 흔적

# Java 기초 문법 공부를 위한 자바 환경 구성하기 (feat. Visual Studio Code)

eblessyou 2026. 6. 4. 14:19

 

내 질문:

자바 언어에 대해서 기초 공부를 하고,

앞으로 스프링 부트에 대해서 2.5개월동안 학습할 예정인데,

어떤 툴을 사용하는 게 나을까?

지금 기본적으로는 vscode를 사용하고 있는데,

자바 기초 공부를 가르쳐주는 선생님은 이클립스를 설치하라고 얘기하셔가지고...

참고로 스프링 부트 선생님은 또 다른 분이라

어떤 프로그램을 설치해서 자바를 사용하게 될지 모르겠어.

내가 자바에 대해 기초 개념도 잘 없어서 그런데 네가 나에게 맞게 프로그램과 자바 환경을 추천해줄래?

 

 

지금 상황은 “수업 호환성”과 “앞으로 스프링 부트까지 갈 확장성”을 같이 봐야 합니다. 설치 조합을 너무 많이 늘리지 않는 방향으로, 공식 문서 기준으로 확인해서 추천을 정리해볼게요.

26s 동안 생각함

얼론투게더에게는 “기초 수업은 이클립스, 개인 학습과 스프링 부트 준비는 VS Code 유지, 가능하면 나중에 IntelliJ IDEA 검토” 조합을 추천합니다.

가장 중요한 건 IDE보다 JDK 환경을 제대로 맞추는 것입니다. IDE는 바꿀 수 있지만, Java 버전과 프로젝트 구조가 꼬이면 초보 단계에서 많이 힘들어집니다.

결론부터 추천

1순위 추천 환경

                     용도                                                                                           추천
Java 기초 수업 따라가기 Eclipse 설치
평소 개인 연습 VS Code 유지
Spring Boot 본격 학습 선생님 도구 확인 전까지는 VS Code + Spring Boot 확장팩으로 준비
가능하면 나중에 IntelliJ IDEA도 고려

즉, 지금 VS Code를 지우거나 버릴 필요는 없습니다. 다만 기초 자바 선생님이 Eclipse로 설명한다면 Eclipse는 설치하는 게 맞습니다. 초보 단계에서는 선생님 화면과 내 화면의 메뉴, 실행 버튼, 프로젝트 구조가 다르면 따라가다가 막힐 확률이 높습니다.

내가 추천하는 설치 조합

1. JDK: Java 17 설치 추천

스프링 부트는 현재 공식 문서 기준으로 최소 Java 17 이상을 요구합니다. Spring Boot 4.0.6도 Java 17 이상이 필요하고, Maven 3.6.3 이상 또는 Gradle 8.x/9.x를 지원합니다.

그래서 처음에는 JDK 17 LTS를 추천합니다.

Java 21도 좋지만, 학원/수업 자료가 Java 17 기준일 가능성이 꽤 높습니다. 초보 단계에서는 최신 버전보다 수업 호환성이 더 중요합니다. Adoptium Temurin도 JDK 17, 21, 25 같은 LTS 버전을 제공하고 있습니다.

추천:

Eclipse Temurin JDK 17
 

주의할 점은 JRE가 아니라 JDK를 설치해야 한다는 것입니다. JDK가 있어야 컴파일, 실행, 개발이 가능합니다.

IDE별 추천 판단

1. Eclipse: 수업용으로 설치 추천

Eclipse는 Java 기초 수업에서 많이 씁니다. 장점은 선생님이 설명하는 화면과 거의 똑같이 따라갈 수 있다는 점입니다.

다만 UI가 조금 오래된 느낌이고, 처음에는 workspace, project, package, class 구조가 낯설 수 있습니다. 그래도 Java 기초를 배우는 동안에는 충분합니다.

Spring 쪽도 Eclipse에서 불가능한 것은 아닙니다. Spring 공식 도구인 Spring Tools는 Eclipse, VS Code, Theia 등 여러 환경을 지원하고, Spring Boot 개발용 기능을 제공합니다.

추천 설치:

Eclipse IDE for Java Developers
 

나중에 Spring Boot까지 Eclipse로 계속 간다면:

Spring Tools for Eclipse
 

또는 Eclipse에 Spring Tools 플러그인을 추가하면 됩니다.

2. VS Code: 계속 써도 됨

이미 VS Code에 익숙하다면 계속 써도 됩니다. 공식 VS Code 문서에서도 Spring Boot 개발을 위해 JDK, Extension Pack for Java, Spring Boot Extension Pack 설치를 안내하고 있고, Spring Initializr, Spring Boot Dashboard, application.yml/properties 지원 같은 기능을 제공합니다.

VS Code의 장점은 가볍고, HTML/CSS/JS/PHP 같은 웹 개발과 같이 쓰기 좋다는 점입니다. 지금 사용자가 웹개발 과정도 같이 하고 있다면 VS Code는 계속 유용합니다.

VS Code에 설치하면 좋은 확장:

Extension Pack for Java
Spring Boot Extension Pack
 

다만 초보자 입장에서는 Java 프로젝트 구조나 실행 설정이 Eclipse/IntelliJ보다 덜 직관적으로 느껴질 수 있습니다. 특히 에러가 났을 때 “내 코드 문제인지, 확장 설정 문제인지, JDK 경로 문제인지” 헷갈릴 수 있습니다.

3. IntelliJ IDEA: Spring Boot 때 가장 편할 가능성이 큼

Spring Boot를 본격적으로 할 때는 개인적으로 IntelliJ IDEA가 가장 편합니다. 코드 자동완성, 리팩토링, Maven/Gradle 프로젝트 인식, 디버깅, 클래스 이동, 에러 표시가 강합니다.

하지만 중요한 단점이 있습니다. JetBrains 공식 문서에 따르면 Spring 지원은 Ultimate 구독판에서 기본 제공되고, Ultimate 없이 쓰는 경우 Spring 지원이 제한됩니다.

즉:

                                    버전                                                                                     추천도
IntelliJ IDEA Community Java 기초, Maven/Gradle 연습은 가능
IntelliJ IDEA Ultimate Spring Boot 학습에 매우 좋음
유료 부담 있음 VS Code 또는 Eclipse로 충분히 가능

학생/교육기관 라이선스를 받을 수 있다면 IntelliJ IDEA Ultimate를 고려해볼 만합니다. 아니라면 당장 무리해서 설치할 필요는 없습니다.

최종 추천 루트

내가 얼론투게더 상황이라면 이렇게 갑니다.

지금부터 Java 기초 수업까지

JDK 17
Eclipse
VS Code 유지
 

기초 수업은 Eclipse로 따라가세요. 선생님이 Eclipse 기준으로 설명하면 그대로 따라가는 게 훨씬 덜 헷갈립니다.

개인 복습

VS Code 또는 Eclipse 둘 다 가능
 

단, 초반 2~3주는 Eclipse로만 연습하는 것도 좋습니다. IDE를 왔다 갔다 하면 “자바 개념”보다 “툴 차이” 때문에 헷갈릴 수 있습니다.

Spring Boot 시작 직전

스프링 부트 선생님이 사용하는 도구를 확인한 뒤 결정하세요.

     스프링 선생님 도구                                                                 그대로 따라갈 도구
Eclipse / STS Eclipse + Spring Tools
VS Code VS Code + Java Extension Pack + Spring Boot Extension Pack
IntelliJ IntelliJ IDEA
아무거나 가능 VS Code 유지 또는 IntelliJ IDEA 추천

설치 우선순위

처음부터 너무 많이 깔 필요는 없습니다.

1. JDK 17
2. Eclipse
3. VS Code Java 확장팩
4. Git
5. Spring Boot 시작할 때 Maven/Gradle 확인
 

Maven과 Gradle은 Spring Boot 프로젝트를 만들면 같이 접하게 됩니다. 초반에는 직접 깊게 설치/설정하려고 하기보다, IDE가 프로젝트를 인식하게 하는 정도로 시작하면 됩니다.

한 줄 결론

지금은 Eclipse를 설치해서 Java 기초 수업을 따라가고, VS Code는 계속 유지하세요. Spring Boot는 선생님 도구가 확인되기 전까지 VS Code + Java/Spring 확장팩으로 준비하면 충분합니다. 나중에 IntelliJ IDEA Ultimate를 쓸 수 있는 상황이면 Spring Boot 학습용으로 가장 편한 선택지가 될 가능성이 높습니다.

 

 

내 질문:

그럼 이클립스를 따로 설치하지 않고 vscode로 자바 수업을 따라가도 괜찮다는 소리네?

지금 이미 내 노트북에 아파치랑 php프로그램도 설치되어 있고,

앞으로 스프링부트 할 때도 프로그램을 더 설치할 텐데,

지금 기초 문법만을 위해서 오래된 프로그램인 이클립스를 설치해서 사용하는 건 좀 비효율적인 거 같아서.

화면이 조금 달라서 어렵더라도 어차피 기초 문법을 '공부'하는 게 중요한 거니,

vscode에서 자바를 사용할 수 있는 게 더 낫지 않을까 싶은데.

그럴 경우에 vscode에서 내가 추가적으로 설치해야 할 프로그램이 있을까?

아니면 그냥 바로 vscode에서 자바 사용이 가능해?

 

 

맞아요. 이클립스를 꼭 설치하지 않고 VS Code로 자바 기초 수업을 따라가도 괜찮습니다.
특히 지금처럼 이미 VS Code에 익숙하고, Apache/PHP 환경도 있고, 앞으로 Spring Boot까지 갈 예정이라면 VS Code 중심으로 자바 환경을 잡는 선택은 충분히 합리적입니다.

다만 중요한 점은 하나예요.

VS Code만 있다고 자바가 바로 되는 것은 아닙니다.
VS Code는 편집기이고, 실제 자바 코드를 컴파일하고 실행하려면 JDK와 자바 확장팩이 필요합니다.

얼론투게더에게 추천하는 구성

1. JDK 17 설치
2. VS Code에 Extension Pack for Java 설치
3. 나중에 Spring Boot Extension Pack 설치
 

이렇게만 해도 자바 기초 문법 공부는 충분히 가능합니다.

1. JDK는 꼭 설치해야 함

먼저 터미널에서 아래 명령어를 입력해보세요.

 
java -version
javac -version
 

둘 다 버전이 나오면 JDK가 이미 설치되어 있을 가능성이 높습니다.

예를 들어 이런 식이면 괜찮습니다.

java version "17..."
javac 17...
 

그런데 javac가 안 나오거나, 명령어를 찾을 수 없다고 나오면 JDK를 설치해야 합니다.

추천은:

Eclipse Temurin JDK 17
 

입니다.

Spring Boot는 공식 문서 기준으로 Java 17 이상이 필요하고, Spring Boot 설치 문서에서도 Java SDK 17 이상을 요구합니다. 그래서 지금부터 Java 17로 맞춰두면 자바 기초와 Spring Boot 준비를 동시에 할 수 있습니다.

Adoptium Temurin은 JDK 17 LTS를 제공하고 있고, Windows/macOS/Linux용 JDK를 받을 수 있습니다. 설치할 때는 JRE가 아니라 JDK를 선택해야 합니다.

2. VS Code에는 자바 확장팩이 필요함

VS Code에서 자바를 제대로 쓰려면 확장 프로그램에서 아래를 설치하세요.

Extension Pack for Java
 

이 확장팩은 자바 자동완성, 실행, 디버깅, 테스트, 프로젝트 관리 같은 기본 기능을 제공하는 공식 추천 확장팩입니다.

VS Code의 Java Projects 화면에서도 프로젝트와 의존성을 관리할 수 있고, 자바 프로젝트 작업을 위한 진입점들이 제공됩니다.

3. Spring Boot 시작 전에는 이것도 설치

Spring Boot 수업 들어가기 전에는 VS Code에 아래를 추가하면 됩니다.

Spring Boot Extension Pack
 

VS Code 공식 문서에서도 Spring Boot 개발을 위해 필요한 것으로 JDK, Extension Pack for Java, Spring Boot Extension Pack을 안내하고 있습니다.

즉, 지금 당장은 Spring Boot 확장팩까지 꼭 설치하지 않아도 되고, 자바 기초 문법 공부를 시작하려면 우선 이 정도면 됩니다.

JDK 17
Extension Pack for Java
 

설치를 최소화하고 싶다면 이렇게 하세요

지금 바로 필요한 것

필수:
- JDK 17
- VS Code
- Extension Pack for Java
 

나중에 Spring Boot 시작할 때

추가:
- Spring Boot Extension Pack
 

당장 필요 없는 것

- Eclipse
- IntelliJ
- STS
- Maven/Gradle 별도 설치
 

Maven/Gradle은 Spring Boot 프로젝트를 만들면서 자연스럽게 접하게 됩니다. VS Code의 Java/Spring 확장 환경에서도 Maven/Gradle 프로젝트를 다룰 수 있으니, 처음부터 따로 과하게 설치할 필요는 없습니다. VS Code 공식 문서도 Maven for Java와 Gradle for Java 확장을 통해 Java 빌드 도구 작업을 다룬다고 설명합니다.

선생님이 Eclipse로 수업해도 괜찮을까?

괜찮습니다. 다만 화면이 다르기 때문에 아래 정도는 스스로 대응할 수 있어야 합니다.

                      선생님이 Eclipse에서 하는 것                                                           VS Code에서 대응
New Java Project Create Java Project
New Class 새 .java 파일 생성
Run As Java Application Run 버튼 또는 java 파일명 실행
Console Terminal 또는 Debug Console
Package Explorer Explorer / Java Projects

기초 문법 수업이라면 대부분은 IDE 기능보다 아래 내용을 배우는 것이 핵심입니다.

변수
자료형
조건문
반복문
배열
메서드
클래스
객체
상속
인터페이스
예외 처리
 

이런 내용은 Eclipse든 VS Code든 똑같이 공부할 수 있습니다.

내 추천은 이거예요

얼론투게더 상황에서는 Eclipse 설치 안 해도 됩니다.

대신 아래처럼 하세요.

1. JDK 17 설치 여부 확인
2. 없으면 Temurin JDK 17 설치
3. VS Code에서 Extension Pack for Java 설치
4. 간단한 HelloWorld.java 실행 확인
5. Spring Boot 시작 전에 Spring Boot Extension Pack 추가
 

확인용으로 VS Code에서 아래 파일을 만들어 실행해보면 됩니다.

 
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, Java!");
    }
}
 

이게 실행되면 자바 기초 수업을 VS Code로 따라갈 준비는 된 겁니다.

정리하면, 기초 문법만을 위해 Eclipse를 추가 설치하는 건 꼭 필요하지 않습니다.
선생님 화면과 달라서 약간 불편할 수는 있지만, 앞으로 Spring Boot와 웹개발까지 생각하면 VS Code 중심으로 환경을 통일하는 선택이 더 깔끔할 수 있습니다.

 

 

내 질문:

1. JDK 17 설치 여부 확인

2. 없으면 Temurin JDK 17 설치

3. VS Code에서 Extension Pack for Java 설치

4. 간단한 HelloWorld.java 실행 확인

5. Spring Boot 시작 전에 Spring Boot Extension Pack 추가

 

그럼 네가 알려준 순서대로 초보자도 따라 설치하기 쉽게, 차근차근 설명해줄래?

 

 

설치 안내는 버전/화면명이 바뀔 수 있어서, 공식 문서 기준으로 맞춰서 설명하겠습니다. Windows 노트북 기준으로 쓰되, macOS인 경우도 따라갈 수 있게 필요한 차이만 같이 적을게요.

15s 동안 생각함

좋아요. VS Code로 Java 기초 → Spring Boot 준비까지 가는 흐름으로, 초보자 기준 설치 순서를 차근차근 정리해드릴게요.

아래는 Windows 노트북 기준입니다. macOS라면 중간에 따로 적어둔 부분만 보면 됩니다.

전체 순서

1. 내 컴퓨터에 Java가 이미 있는지 확인
2. 없거나 버전이 낮으면 Temurin JDK 17 설치
3. 환경변수 확인
4. VS Code에 Extension Pack for Java 설치
5. HelloWorld.java 실행 테스트
6. Spring Boot 시작 전에 Spring Boot Extension Pack 설치
 

Spring Boot는 현재 공식 요구사항 기준으로 Java 17 이상이 필요하므로, 지금부터 JDK 17로 맞춰두는 게 안전합니다.

1단계. JDK 17 설치 여부 확인하기

먼저 VS Code를 열 필요 없이, Windows에서 터미널을 열어주세요.

Windows에서 터미널 여는 방법

  1. 키보드에서 Windows 키 누르기
  2. cmd 또는 PowerShell 검색
  3. 실행

그리고 아래 명령어를 하나씩 입력하세요.

 
java -version
 

그다음:

 
javac -version
 

결과 해석

좋은 상태

아래처럼 둘 다 17이 나오면 이미 준비된 상태입니다.

java version "17..."
javac 17...
 

또는 이런 식도 괜찮습니다.

openjdk version "17..."
javac 17...
 

이 경우에는 JDK 설치를 새로 하지 않아도 됩니다.

설치가 필요한 상태

아래처럼 나오면 JDK를 설치해야 합니다.

'java'은(는) 내부 또는 외부 명령...
 

또는:

'javac'은(는) 내부 또는 외부 명령...
 

특히 java -version은 되는데 javac -version이 안 되면, 개발용 JDK가 아니라 실행용 Java만 있거나 PATH 설정이 안 된 상태일 수 있습니다.

2단계. Temurin JDK 17 설치하기

JDK가 없거나 버전이 17보다 낮으면 Eclipse Temurin JDK 17을 설치하세요.

Adoptium Temurin은 Windows, macOS, Linux용 OpenJDK 바이너리를 제공하는 배포판입니다.

설치할 때 선택할 것

다운로드 페이지에서 대략 이런 기준으로 고르면 됩니다.

Version: 17 - LTS
Operating System: Windows
Architecture: x64
Package Type: JDK
 

중요합니다.

JRE 말고 JDK를 설치해야 합니다.
 

JDK가 있어야 javac로 컴파일할 수 있습니다.

Windows 설치 중 체크하면 좋은 옵션

설치 화면에서 아래와 비슷한 옵션이 보이면 체크하세요.

Set JAVA_HOME variable
Add to PATH
 

이 옵션 이름은 설치 프로그램 버전에 따라 조금 다를 수 있습니다. 보이면 체크하는 게 좋습니다.

설치가 끝났으면 터미널을 완전히 닫았다가 다시 열고, 다시 확인하세요.

 
java -version
javac -version
 

둘 다 17이 나오면 성공입니다.

macOS라면

macOS도 Temurin JDK 17을 설치하면 됩니다. 설치 후 터미널에서 똑같이 확인하세요.

 
java -version
javac -version
 

3단계. 환경변수 확인하기

보통 Temurin 설치 과정에서 PATH가 자동 설정되면 따로 건드릴 필요 없습니다.

하지만 설치했는데도 java 또는 javac 명령어가 안 되면 환경변수 문제일 수 있습니다.

Windows에서 확인

터미널에서 아래 명령어를 입력하세요.

 
where java
 

그리고:

 
where javac
 

정상이라면 대략 이런 경로가 나옵니다.

C:\Program Files\Eclipse Adoptium\jdk-17...\bin\java.exe
C:\Program Files\Eclipse Adoptium\jdk-17...\bin\javac.exe
 

그래도 안 되면

Windows에서 직접 환경변수를 확인합니다.

  1. Windows 검색창에 환경 변수 입력
  2. 시스템 환경 변수 편집 클릭
  3. 환경 변수 버튼 클릭
  4. 시스템 변수에서 Path 선택
  5. 편집 클릭
  6. 아래와 비슷한 경로가 있는지 확인
C:\Program Files\Eclipse Adoptium\jdk-17...\bin
 

없으면 추가해야 합니다.

그리고 가능하면 시스템 변수에 JAVA_HOME도 추가합니다.

변수 이름: JAVA_HOME
변수 값: C:\Program Files\Eclipse Adoptium\jdk-17...
 

주의할 점은 JAVA_HOME에는 bin까지 넣지 않는 것입니다.

좋음:
C:\Program Files\Eclipse Adoptium\jdk-17...

안 좋음:
C:\Program Files\Eclipse Adoptium\jdk-17...\bin
 

4단계. VS Code에 Java 확장팩 설치하기

이제 VS Code를 엽니다.

왼쪽 메뉴에서 Extensions 아이콘을 클릭하거나 단축키를 누르세요.

Ctrl + Shift + X
 

검색창에 아래를 입력합니다.

Extension Pack for Java
 

그리고 Microsoft에서 제공하는 확장팩을 설치하세요.

VS Code 공식 문서에 따르면 이 확장팩에는 Java 언어 지원, 디버거, 테스트 러너, Maven 지원, 프로젝트 매니저, IntelliCode 등이 포함됩니다.

설치해야 하는 이름:

Extension Pack for Java
 

설치 후 VS Code를 한 번 껐다가 다시 켜는 것을 추천합니다.

5단계. HelloWorld.java 실행 확인하기

이제 진짜로 Java가 실행되는지 확인해봅니다.

5-1. 연습 폴더 만들기

초보자는 경로를 단순하게 만드는 게 좋습니다.

Windows라면 아래처럼 만드는 걸 추천합니다.

C:\java-study
 

또는 바탕화면에 만들어도 됩니다.

Desktop\java-study
 

다만 처음에는 한글 폴더명, 공백 많은 폴더명은 피하는 게 좋습니다.

추천:
C:\java-study

비추천:
C:\자바 수업 파일\첫 번째 연습
 

한글 경로도 보통은 되지만, 초보 단계에서는 혹시 모를 경로 문제를 줄이는 게 좋습니다.

5-2. VS Code에서 폴더 열기

VS Code에서:

File → Open Folder
 

그리고 java-study 폴더를 선택하세요.

5-3. 새 파일 만들기

VS Code 왼쪽 Explorer에서 새 파일을 만듭니다.

파일 이름은 반드시 이렇게 하세요.

HelloWorld.java
 

그리고 아래 코드를 입력합니다.

 
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, Java!");
    }
}
 

중요한 규칙입니다.

public class HelloWorld
파일명 HelloWorld.java
 

이 둘의 이름이 같아야 합니다.

5-4. 실행 방법 1: VS Code Run 버튼 사용

Java 확장팩이 잘 설치되어 있으면 코드 위쪽 또는 main 메서드 위에 이런 버튼이 보일 수 있습니다.

Run
Debug
 

여기서 Run을 누르면 실행됩니다.

아래쪽 터미널이나 출력창에 이렇게 나오면 성공입니다.

Hello, Java!
 

5-5. 실행 방법 2: 터미널로 직접 실행

VS Code 상단 메뉴에서 터미널을 엽니다.

Terminal → New Terminal
 

또는 단축키:

Ctrl + `
 

그다음 현재 위치가 java-study 폴더인지 확인하고, 아래 명령어를 입력하세요.

 
javac HelloWorld.java
 

오류 없이 지나가면 컴파일 성공입니다.

그러면 같은 폴더에 아래 파일이 생깁니다.

HelloWorld.class
 

이제 실행합니다.

 
java HelloWorld
 

결과:

Hello, Java!
 

여기까지 되면 VS Code에서 Java 기초 수업을 따라갈 준비가 된 겁니다.

6단계. Spring Boot 시작 전에 설치할 것

지금 당장 Java 기초 문법만 한다면 Spring Boot 확장팩은 나중에 설치해도 됩니다.

Spring Boot 수업 시작 전에는 VS Code Extensions에서 아래를 검색해서 설치하세요.

Spring Boot Extension Pack
 

VS Code 공식 Spring Boot 문서에서도 Spring Boot 개발을 위해 JDK, Extension Pack for Java, Spring Boot Extension Pack을 안내합니다.

이 확장팩을 설치하면 Spring Initializr로 프로젝트를 만들거나, Spring Boot 프로젝트를 실행/관리하는 데 도움이 됩니다.

지금 당장 설치해야 하는 것만 정리

현재 Java 기초 수업용으로는 이것만 있으면 됩니다.

필수:
1. JDK 17
2. VS Code
3. Extension Pack for Java
 

Spring Boot 들어가기 전에는 추가로:

4. Spring Boot Extension Pack
 

지금 당장 필요 없는 것:

Eclipse
IntelliJ
STS
Maven 별도 설치
Gradle 별도 설치
 

기초 문법 공부 단계에서는 javac, java, VS Code 실행 버튼만으로 충분합니다.

자주 막히는 문제

1. javac가 안 된다고 나올 때

원인:

JDK가 설치되지 않았거나 PATH가 안 잡힌 상태
 

해결:

Temurin JDK 17 설치
설치 후 터미널 재시작
java -version
javac -version 재확인
 

2. 파일명 오류

이런 코드라면:

 
public class HelloWorld {
}
 

파일명은 반드시:

HelloWorld.java
 

여야 합니다.

아래처럼 만들면 오류가 납니다.

hello.java
test.java
Hello.java
 

3. 실행할 때 .java를 붙이면 안 되는 경우

컴파일은 이렇게 합니다.

 
javac HelloWorld.java
 

실행은 이렇게 합니다.

 
java HelloWorld
 

실행할 때는 아래처럼 쓰면 안 됩니다.

 
java HelloWorld.java
 

초반에는 이 실수를 많이 합니다.

4. package 관련 오류

수업 자료에서 코드를 복사했는데 맨 위에 이런 줄이 있을 수 있습니다.

 
package chapter01;
 

그런데 내 파일이 실제로 chapter01 폴더 구조 안에 없으면 오류가 날 수 있습니다.

처음 연습할 때는 이런 줄은 지우고 시작해도 됩니다.

 
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, Java!");
    }
}
 

추천 학습 폴더 구조

자바 기초 수업을 VS Code로 따라갈 거면 이렇게 정리하면 좋습니다.

C:\java-study
  ├─ day01
  │   ├─ HelloWorld.java
  │   └─ VariableTest.java
  ├─ day02
  │   ├─ IfTest.java
  │   └─ LoopTest.java
  └─ day03
      ├─ ArrayTest.java
      └─ MethodTest.java
 

처음에는 너무 프로젝트처럼 복잡하게 만들지 말고, 수업 날짜별로 .java 파일을 나눠서 연습하면 됩니다.

최종 체크리스트

아래가 전부 되면 성공입니다.

[ ] java -version 입력 시 17이 나온다
[ ] javac -version 입력 시 17이 나온다
[ ] VS Code에 Extension Pack for Java가 설치되어 있다
[ ] HelloWorld.java 파일을 만들었다
[ ] Run 버튼 또는 터미널로 실행했다
[ ] Hello, Java!가 출력됐다
 

이 상태면 Eclipse 없이 VS Code로 Java 기초 수업을 따라가도 됩니다.

 

 

내 질문:

5-4. 실행 방법 1: VS Code Run 버튼 사용

Java 확장팩이 잘 설치되어 있으면 코드 위쪽 또는 main 메서드 위에 이런 버튼이 보일 수 있습니다.

Run

Debug

여기서 Run을 누르면 실행됩니다.

아래쪽 터미널이나 출력창에 이렇게 나오면 성공입니다.

Hello, Java!

5-5. 실행 방법 2: 터미널로 직접 실행

VS Code 상단 메뉴에서 터미널을 엽니다.

Terminal → New Terminal

또는 단축키:

Ctrl + `

그다음 현재 위치가 java-study 폴더인지 확인하고, 아래 명령어를 입력하세요.

javac HelloWorld.java

오류 없이 지나가면 컴파일 성공입니다.

그러면 같은 폴더에 아래 파일이 생깁니다.

HelloWorld.class

이제 실행합니다.

java HelloWorld

결과: Hello, Java!

여기까지 되면 VS Code에서 Java 기초 수업을 따라갈 준비가 된 겁니다.

 

그럼 네가 알려준 이 HelloWorld 부분을 초보자도 알기 쉽게 설명해줄래?

그리고 왜 run으로 실행하는 방법과 터미널로 실행하는 방법이 나뉘는지,

어떤 식으로 다른지, 둘 다 꼭 해야 하는지 아니면 하지 않아도 되는지,

class 파일은 왜 생기는지 등등. 알기 쉽게 설명해줘.

 

 

좋아요. 이제 실행이 잘 된다면, 지금부터는 **“내가 누른 Run 버튼 뒤에서 실제로 무슨 일이 일어나는지”**를 이해하면 됩니다.

자바 초보 단계에서 HelloWorld.java는 단순한 예제가 아니라, 자바 실행 구조를 이해하는 첫 번째 예제예요.

1. HelloWorld.java는 무엇인가?

우리가 만든 파일은 이것이었죠.

 
public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, Java!");
    }
}
 

파일 이름은:

HelloWorld.java
 

입니다.

여기서 .java 파일은 사람이 읽고 작성하는 자바 소스 코드 파일입니다.

비유하면:

HelloWorld.java = 사람이 쓴 원고
 

아직 컴퓨터가 바로 실행할 수 있는 완성 파일은 아닙니다.

2. 왜 파일 이름과 클래스 이름이 같아야 할까?

코드 첫 줄을 보면:

 
public class HelloWorld {
 

여기서 HelloWorld는 클래스 이름입니다.

그리고 파일 이름도:

HelloWorld.java
 

입니다.

자바에서는 public class가 있는 경우, 파일 이름과 public class 이름이 반드시 같아야 합니다.

즉:

 
public class HelloWorld
 

라면 파일명은 반드시:

HelloWorld.java
 

여야 합니다.

아래처럼 하면 안 됩니다.

파일명: Test.java

public class HelloWorld {
}
 

이러면 자바가 이렇게 생각합니다.

공개 클래스 이름은 HelloWorld인데,
파일 이름은 Test.java네?
규칙이 안 맞음.
 

그래서 오류가 납니다.

초보자는 이렇게 기억하면 됩니다.

public class 이름 = 파일 이름
 

단, .java 확장자는 제외하고 비교합니다.

HelloWorld.java
→ HelloWorld
 

3. main은 무엇인가?

이 부분이 중요합니다.

 
public static void main(String[] args) {
    System.out.println("Hello, Java!");
}
 

자바 프로그램을 실행하면 자바는 먼저 이렇게 찾습니다.

어디서부터 실행해야 하지?
 

그 시작점이 바로 main입니다.

즉:

 
public static void main(String[] args)
 

는 자바 프로그램의 시작 버튼 같은 역할을 합니다.

초보 단계에서는 일단 이렇게 외워도 됩니다.

자바 프로그램은 main 메서드 안에서 시작된다.
 

그래서 실제로 실행되는 코드는 이 안쪽입니다.

 
System.out.println("Hello, Java!");
 

4. System.out.println()은 무엇인가?

 
System.out.println("Hello, Java!");
 

이 코드는 화면에 글자를 출력하라는 뜻입니다.

System.out.println("출력할 내용");
 

그래서 실행 결과가:

Hello, Java!
 

로 나옵니다.

여기서 "Hello, Java!"처럼 큰따옴표 안에 들어간 내용은 문자열입니다.

5. Run 버튼으로 실행하면 무슨 일이 일어날까?

VS Code에서 Run 버튼을 누르면, VS Code가 뒤에서 자동으로 이런 일을 해줍니다.

1. 이 파일이 자바 파일인지 확인
2. 자바 컴파일러로 컴파일
3. 실행 가능한 형태로 바꿈
4. JVM으로 실행
5. 결과를 터미널 또는 출력창에 보여줌
 

즉, Run 버튼은 초보자가 편하게 실행할 수 있도록 컴파일과 실행 과정을 자동으로 처리해주는 기능입니다.

우리가 직접 명령어를 치지 않아도 VS Code가 대신 처리해주는 거예요.

6. 터미널로 실행하면 무슨 일이 일어날까?

터미널에서는 우리가 직접 두 단계를 입력했습니다.

 
javac HelloWorld.java
 

그리고:

 
java HelloWorld
 

이 두 명령어는 역할이 다릅니다.

6-1. javac HelloWorld.java

 
javac HelloWorld.java
 

여기서 javac는 Java Compiler, 즉 자바 컴파일러입니다.

이 명령어는 사람이 작성한 .java 파일을 컴퓨터가 실행할 수 있는 중간 형태로 바꿉니다.

HelloWorld.java
↓ javac
HelloWorld.class
 

즉:

.java 파일 = 사람이 작성한 소스 코드
.class 파일 = 자바가 실행할 수 있는 바이트코드
 

6-2. java HelloWorld

 
java HelloWorld
 

이 명령어는 컴파일된 HelloWorld.class 파일을 실행합니다.

여기서 주의할 점은 실행할 때는 .class를 붙이지 않는다는 것입니다.

좋은 예:

 
java HelloWorld
 

나쁜 예:

 
java HelloWorld.class
 

왜냐하면 java HelloWorld는 자바에게 이렇게 말하는 것과 같습니다.

HelloWorld라는 클래스를 찾아서 실행해줘.
 

파일명을 직접 실행한다기보다, 클래스 이름을 기준으로 실행하는 방식입니다.

7. .class 파일은 왜 생길까?

이게 자바의 중요한 특징입니다.

자바는 우리가 쓴 .java 파일을 바로 실행하지 않습니다.

먼저 컴파일해서 .class 파일을 만듭니다.

HelloWorld.java
→ 컴파일
→ HelloWorld.class
→ 실행
 

.class 파일 안에는 우리가 작성한 코드가 바이트코드라는 형태로 들어 있습니다.

바이트코드는 사람이 읽기 쉬운 코드가 아닙니다. 대신 JVM이 읽고 실행할 수 있는 코드입니다.

사람이 읽는 코드: HelloWorld.java
JVM이 읽는 코드: HelloWorld.class
 

8. JVM은 무엇인가?

JVM은 Java Virtual Machine입니다.

쉽게 말하면:

자바 프로그램을 실행해주는 가상 컴퓨터
 

입니다.

자바는 운영체제마다 따로 실행 파일을 만드는 방식이 아니라, .class라는 바이트코드를 만들고 JVM이 그걸 실행합니다.

흐름은 이렇게 됩니다.

내가 쓴 코드
HelloWorld.java

↓ javac로 컴파일

자바 바이트코드
HelloWorld.class

↓ java 명령어로 실행

JVM이 실행
 

그래서 자바는 이런 구조를 가집니다.

.java → .class → JVM 실행
 

이 흐름만 이해해도 자바 실행 원리의 큰 틀은 잡은 겁니다.

9. Run 버튼과 터미널 실행의 차이

둘 다 결국 같은 일을 합니다.

다만 누가 처리하느냐가 다릅니다.

                    방식                                                                                        설명
Run 버튼 VS Code가 컴파일과 실행을 자동 처리
터미널 실행 내가 직접 javac, java 명령어 입력

좀 더 쉽게 말하면:

Run 버튼 = 자동 모드
터미널 실행 = 수동 모드
 

Run 버튼은 편합니다.
터미널 실행은 원리를 이해하기 좋습니다.

10. 둘 다 꼭 해야 할까?

매번 둘 다 할 필요는 없습니다.

기초 수업을 따라갈 때는 보통:

Run 버튼으로 실행해도 충분
 

합니다.

다만 초보 단계에서 터미널 실행을 한 번쯤 해보는 건 아주 좋습니다. 이유는 자바가 실제로 어떻게 실행되는지 알 수 있기 때문입니다.

정리하면:

                                                상황                                                                                        추천 방식
수업 따라가며 빠르게 확인 Run 버튼
자바 실행 원리 이해 터미널
에러 원인 분석 터미널이 도움 됨
매일 코딩 연습 Run 버튼만 써도 됨
시험/수업에서 명령어 요구 터미널도 알아야 함

얼론투게더는 지금 둘 다 성공했으니까, 앞으로는 평소에는 Run 버튼으로 실행하고, 가끔 원리 확인할 때 터미널을 쓰면 됩니다.

11. .class 파일은 지워도 될까?

네, 지워도 됩니다.

예를 들어 폴더 안에 이런 파일이 생깁니다.

HelloWorld.java
HelloWorld.class
 

여기서 중요한 원본은:

HelloWorld.java
 

입니다.

.class 파일은 컴파일하면 다시 생깁니다.

그래서 .class 파일을 삭제해도:

 
javac HelloWorld.java
 

를 다시 실행하면 다시 만들어집니다.

즉:

.java 파일 = 원본
.class 파일 = 실행을 위해 만들어진 결과물
 

초보자는 .java 파일만 잘 보관하면 됩니다.

12. 왜 Run 버튼으로 실행했을 때는 .class 파일이 잘 안 보일 수도 있을까?

VS Code의 Java 확장팩은 상황에 따라 컴파일 결과를 숨겨진 폴더나 내부 작업 공간에서 관리할 수 있습니다.

그래서 Run 버튼으로 실행했을 때는 내가 직접 HelloWorld.class 파일을 못 볼 수도 있습니다.

하지만 터미널에서:

 
javac HelloWorld.java
 

를 실행하면 보통 같은 폴더에:

HelloWorld.class
 

가 직접 생깁니다.

즉:

Run 버튼: VS Code가 뒤에서 알아서 처리
터미널 javac: 내가 직접 컴파일해서 .class 파일을 확인 가능
 

이 차이입니다.

13. 전체 흐름을 그림처럼 보면

자바 코드는 이렇게 실행됩니다.

1. 코드 작성

HelloWorld.java

↓
2. 컴파일

javac HelloWorld.java

↓
3. class 파일 생성

HelloWorld.class

↓
4. 실행

java HelloWorld

↓
5. 결과 출력

Hello, Java!
 

VS Code Run 버튼은 이 과정을 한 번에 해줍니다.

Run 버튼 클릭
↓
VS Code가 컴파일 + 실행
↓
Hello, Java! 출력
 

14. 지금 단계에서 꼭 기억할 것

지금은 아래만 정확히 이해하면 됩니다.

1. .java는 내가 작성하는 자바 소스 파일이다.
2. public class 이름과 파일 이름은 같아야 한다.
3. main 메서드가 프로그램 시작점이다.
4. javac는 컴파일 명령어다.
5. java는 실행 명령어다.
6. .class 파일은 컴파일 결과물이다.
7. Run 버튼은 이 과정을 자동으로 해준다.
 

15. 앞으로는 어떻게 하면 좋을까?

기초 문법 공부할 때는 이렇게 하면 됩니다.

수업 중:
Run 버튼으로 빠르게 실행

복습할 때:
가끔 터미널에서 javac/java로 실행해보기

.class 파일:
신경 쓰지 않아도 됨
삭제해도 됨
 

지금 단계에서 중요한 건 .class 파일을 관리하는 것이 아니라, 변수, 조건문, 반복문, 배열, 메서드, 클래스 같은 자바 문법을 이해하는 것입니다.

그래서 앞으로는 편하게 VS Code Run 버튼으로 실행하면서 공부해도 괜찮습니다.
터미널 실행은 “자바가 내부적으로 이렇게 돌아가는구나”를 이해하기 위한 보조 수단으로 보면 됩니다.

 

 

By. ChatGPT

 

 

저작자표시 비영리 변경금지 (새창열림)

'몸부림의 흔적' 카테고리의 다른 글

# C언어의 구조체란? (Java의 클래스와 비교해서 알기 쉽게 개념 이해하기)  (0) 2026.06.02
# 먼저 익혀두면 좋은, 자바스크립트의 주요 키워드와 문법 요소들 (feat. const/let/var 호이스팅 개념, console.log())  (0) 2026.06.02
# 컴파일러(Compiler)와 인터프리터(Interpreter) 설명&비교  (0) 2026.06.02
# HTML과 JavaScript를 연결하는 방법이 내부/외부로 나뉘는 이유 (feat. Code Runner 실행 중 node.js 설치 & node.js의 쓰임새 및 공부 순서)  (0) 2026.06.02
# Java 생초보가 꼭 알아야 하는 핵심 문법과 개념 15가지  (0) 2026.05.21