이클립스(Eclipse)는 자바(Java) 개발자들이 가장 많이 사용하는 통합 개발 환경(IDE) 중 하나입니다. 이클립스를 성공적으로 사용하기 위해서는 반드시 자바 개발 키트(JDK)가 올바르게 설치되어 있어야 합니다. 2025년 현재, 자바와 이클립스의 최신 버전은 꾸준히 업데이트되고 있으므로, 안정적이고 최적화된 개발 환경을 구축하는 방법을 상세히 알려드리겠습니다.
📚 함께 읽으면 좋은 글
이 포스팅에서는 이클립스와 JDK를 설치하고, 두 소프트웨어를 완벽하게 연결하여 첫 번째 자바 프로젝트를 시작할 수 있도록 단계별 가이드를 제공합니다. 초보자도 쉽게 따라할 수 있도록 그림과 함께 자세히 설명하겠습니다.
JDK 최신 버전 다운로드 및 설치 과정 확인하기
이클립스를 설치하기에 앞서, 자바 프로그램 실행에 필수적인 JDK(Java Development Kit)를 먼저 설치해야 합니다. 2025년 현재 가장 안정적으로 사용되는 버전은 LTS(Long-Term Support) 버전인 Java 21 또는 그 이후 버전입니다. 오라클(Oracle) 공식 웹사이트에서 다운로드할 수 있습니다.
먼저, 오라클 공식 웹사이트에 접속하여 최신 LTS 버전을 확인하고, 사용자 운영체제(Windows, macOS, Linux)에 맞는 설치 파일을 다운로드합니다. 설치 파일을 실행하면 대부분 ‘Next’ 버튼만 누르면 되는 간단한 과정으로 설치가 완료됩니다.
설치 후에는 명령 프롬프트(CMD) 또는 터미널을 열고 java -version을 입력하여 JDK가 정상적으로 설치되었는지 확인하는 것이 중요합니다. 버전 정보가 올바르게 표시되면 설치가 성공적으로 완료된 것입니다.
이클립스 통합 개발 환경 최신 버전 다운로드 보기
JDK 설치가 완료되었다면 이제 이클립스를 설치할 차례입니다. 이클립스는 공식 웹사이트에서 ‘Eclipse Installer’를 다운로드하여 설치하는 것이 가장 권장되는 방법입니다. 이클립스 인스톨러는 다양한 개발 환경(Java, C/C++, Web 등)에 맞춰 필요한 패키지를 자동으로 설치해줍니다.
2025년 기준으로, 최신 버전의 이클립스 IDE for Java Developers 패키지를 선택하는 것이 일반적인 자바 개발 환경 설정에 가장 적합합니다. 다운로드 받은 인스톨러를 실행하면 설치할 이클립스 버전을 선택하는 화면이 나타납니다.
- Eclipse IDE for Java Developers: 일반적인 자바 애플리케이션 개발에 사용
- Eclipse IDE for Enterprise Java and Web Developers: 웹 및 엔터프라이즈 환경(Spring, Jakarta EE 등) 개발에 사용
자신에게 필요한 버전을 선택하고 설치 경로(Installation Folder)를 지정한 후 ‘Install’ 버튼을 클릭합니다. 설치 과정에서 JDK 설치 경로를 자동으로 감지하여 설정하기 때문에, 앞서 JDK를 성공적으로 설치했다면 별다른 추가 설정 없이 쉽게 설치가 완료됩니다.
자바 환경 변수 설정 상세 더보기
대부분의 운영체제에서는 JDK 설치 시 자동으로 환경 변수를 설정해주지만, 이클립스나 기타 개발 도구에서 자바를 인식하지 못하는 경우가 발생할 수 있습니다. 이럴 때는 수동으로 환경 변수를 설정해주어야 합니다. 환경 변수 설정은 JAVA_HOME 변수를 등록하고 이를 시스템 Path 변수에 추가하는 두 단계로 이루어집니다. 이 과정은 윈도우(Windows)와 맥(macOS)에서 약간의 차이가 있습니다.
윈도우 환경 변수 설정 확인하기
1. JAVA_HOME 설정: 시스템 속성 -> 환경 변수 -> 시스템 변수에서 ‘새로 만들기’를 클릭합니다. 변수 이름에 JAVA_HOME을 입력하고, 변수 값에는 JDK가 설치된 경로(예: C:\Program Files\Java\jdk-21)를 입력합니다.
2. Path 변수 수정: 시스템 변수 목록에서 ‘Path’를 선택하고 ‘편집’을 클릭합니다. 새로 만들기 버튼을 클릭하고 %JAVA_HOME%\bin을 추가합니다. 이는 자바 실행 파일(java.exe, javac.exe 등)이 있는 디렉토리를 시스템 전체에서 접근 가능하도록 만듭니다.
macOS 환경 변수 설정 확인하기
macOS에서는 일반적으로 /usr/libexec/java_home 명령어를 사용하여 JDK 설치 경로를 확인할 수 있습니다. 터미널에서 .zshrc 또는 .bash_profile 파일을 열어 아래와 같은 내용을 추가합니다.
export JAVA_HOME=$(/usr/libexec/java_home) export PATH=$JAVA_HOME/bin:$PATH설정 후에는 터미널에서 source ~/.zshrc 또는 source ~/.bash_profile 명령어를 입력하여 변경된 환경 변수를 즉시 적용해야 합니다. 이렇게 설정하면 이클립스를 비롯한 모든 프로그램에서 올바른 JDK 경로를 참조할 수 있습니다. 자바 환경 변수를 정확하게 설정하는 것이 안정적인 개발 환경 구축의 핵심입니다.
이클립스에서 첫 자바 프로젝트 시작하기 보기
이클립스를 실행하면 가장 먼저 작업 공간(Workspace)을 설정하라는 창이 나타납니다. 워크스페이스는 개발하는 프로젝트들이 저장될 기본 폴더를 의미하며, 원하는 위치를 지정하고 ‘Launch’ 버튼을 클릭합니다.
이클립스가 시작되면, 다음과 같은 순서로 첫 번째 자바 프로젝트를 생성할 수 있습니다.
- 새 자바 프로젝트 생성: File 메뉴 -> New -> Java Project를 선택합니다.
- 프로젝트 설정: 프로젝트 이름(예:
HelloWorldProject)을 입력하고, 사용할 JDK(JRE) 버전을 확인합니다. 이전에 설치한 최신 JDK 버전이 자동으로 선택되었는지 확인합니다. - Hello World 클래스 작성: 생성된 프로젝트의 ‘src’ 폴더를 우클릭 -> New -> Class를 선택합니다. 이름은
HelloWorld로 지정하고,public static void main(String[] args)옵션을 체크하여 main 메소드를 자동으로 생성합니다. - 코드 작성 및 실행: 생성된 클래스 파일에 아래 코드를 작성하고, 상단의 실행(Run) 버튼(녹색 재생 모양)을 클릭하여 결과를 확인합니다.
public class HelloWorld { public static void main(String[] args) { System.out.println("Hello, Eclipse and Java!"); } }이클립스 하단의 콘솔(Console) 창에 “Hello, Eclipse and Java!”라는 문구가 출력되면, JDK와 이클립스 설치 및 환경 설정이 모두 성공적으로 완료된 것입니다. 이제 본격적인 자바 프로그래밍 학습 및 개발을 시작할 준비가 되었습니다.
이클립스 및 JDK 설치 오류 해결 방법 상세 더보기
설치 과정 중 발생할 수 있는 일반적인 오류와 그 해결 방법을 정리했습니다.
| 오류 메시지 | 원인 | 해결 방법 |
|---|---|---|
| “No Java virtual machine was found” | JDK가 설치되지 않았거나 이클립스가 경로를 찾지 못함 | JDK를 다시 설치하거나, 환경 변수(JAVA_HOME 및 Path)를 정확히 설정합니다. |
| 이클립스 실행 중 멈춤 또는 충돌 | JDK/JRE 버전 호환성 문제 또는 메모리 부족 | 이클립스 실행 파일과 함께 있는 eclipse.ini 파일에서 -Xmx 옵션의 메모리 할당량을 늘리거나, 64비트 JDK를 사용합니다. |
| 프로젝트 생성 시 JDK 버전 오류 | 이클립스에 등록된 JRE가 올바르지 않음 | Window -> Preferences -> Java -> Installed JREs에서 올바른 JDK 경로를 다시 등록합니다. |
대부분의 문제는 JDK 설치 및 환경 변수 설정 문제에서 발생합니다. 환경 변수 설정 후에는 반드시 새로운 명령 프롬프트나 터미널 창에서 java -version을 실행하여 변경 사항이 적용되었는지 확인해야 합니다. 만약 문제가 지속된다면, 최신 버전의 이클립스 인스톨러를 재실행하여 설치를 시도하는 것이 좋습니다. 인스톨러가 자동으로 환경을 분석하고 필요한 부분을 업데이트 해 줄 수 있기 때문입니다.
자바 JDK 및 이클립스 2025년 버전 업데이트 확인하기
자바는 매년 3월과 9월에 새로운 버전이 출시됩니다. 2025년 현재 LTS(장기 지원) 버전 외에도 새로운 기능들이 추가된 최신 버전들이 지속적으로 나오고 있습니다. 개발자는 프로젝트의 안정성과 필요에 따라 JDK 버전을 선택해야 합니다. 이클립스 역시 최신 JDK 버전을 지원하기 위해 주기적으로 업데이트되고 있습니다.
이클립스는 ‘Help’ 메뉴의 ‘Check for Updates’를 통해 최신 버전을 확인하고 업데이트할 수 있습니다. 또한, 안정적인 개발을 위해서는 항상 LTS 버전의 JDK를 사용하는 것을 권장하며, 새로운 기능 테스트가 필요할 때만 최신 버전을 설치하여 사용해 보는 것이 일반적인 개발 관행입니다.
성공적으로 개발 환경을 구축한 독자분들은 이제 이클립스 마켓플레이스(Marketplace)에서 필요한 플러그인(Plug-in)들을 추가 설치하여 개발 효율을 높일 수 있습니다. 대표적으로 코드 자동 완성이나 디버깅 기능을 향상시키는 플러그인들이 있습니다.
📌 추가로 참고할 만한 글
자주 묻는 질문(FAQ)
A: 2025년 현재, 장기 지원(LTS) 버전인 Java 21 또는 그 이상의 LTS 버전을 사용하는 것을 권장합니다. 안정성과 보안 업데이트가 지속적으로 제공되어 대부분의 개발 환경에 적합합니다. 최신 이클립스 버전은 최신 JDK를 자동으로 인식하고 지원합니다.
A: 환경 변수 설정 후 반드시 명령 프롬프트(CMD)나 터미널 창을 새로 열어서 java -version 명령어로 제대로 인식되는지 확인해야 합니다. 기존에 열려있던 창에서는 변경된 환경 변수가 적용되지 않을 수 있습니다. 그래도 안 되면 이클립스를 관리자 권한으로 실행해보거나, eclipse.ini 파일의 -vm 옵션을 통해 JDK 경로를 직접 지정해 줄 수 있습니다.
A: 네, 가능합니다. 이클립스 공식 웹사이트의 ‘Packages’ 섹션에서 압축 파일 형태의 이클립스를 다운로드하여 원하는 경로에 압축을 풀고 실행할 수 있습니다. 다만, 이 경우 JDK 설치 경로를 직접 지정해줘야 할 수도 있으며, 인스톨러를 사용하는 것이 가장 간편하고 오류 발생 확률이 적습니다.