Eclipse IDE를 깔았는데 실행이 안 되거나 창이 뜨다 마는 경우가 있습니다. 공식 릴리스 노트(4.41)는 원인을 몇 가지로 꼽습니다. 아래에서 자바 버전, 설치 폴더, 메모리, 워크스페이스 문제를 차례로 정리했습니다.
Eclipse IDE를 깔았는데 실행이 안 되거나 창이 뜨다 마는 경우가 있습니다. 공식 릴리스 노트(4.41)는 원인을 몇 가지로 꼽습니다. 아래에서 자바 버전, 설치 폴더, 메모리, 워크스페이스 문제를 차례로 정리했습니다.
Eclipse IDE 실행에 필요한 자바 버전
Eclipse IDE 2026-09(4.41)는 최소 Java SE 21이 있어야 켜집니다. 설치 프로그램과 패키지에는 JRE가 들어 있지만, 다른 자바 프로그램을 깔면서 PATH가 바뀌면 더 낮은 자바로 실행되려다 멈출 수 있습니다. 공식 문서는 -vm 인자로 쓸 자바를 직접 지정하라고 안내합니다. 예시는 eclipse -vm c:\jdk21\bin\javaw 입니다. 윈도우에서는 eclipse.exe 바로가기를 만들어 속성의 대상 칸 뒤에 이 인자를 붙입니다.
Eclipse IDE 설치 폴더 이름 문제
설치 경로에 들어가면 실행이 안 되는 글자가 정해져 있습니다.
| 구분 | 내용 |
|---|---|
| 실행 막는 글자 | : % # < > ” ! |
| 덮어 설치 | 이전 판 폴더 위에 설치 금지 |
| 해결 | 깨끗한 새 폴더에 다시 설치 |
| 읽기 전용 공유 드라이브 | -configuration 으로 설정 폴더 지정 |
| 기본 설치 위치 | 사용자 폴더 |
| 맥 설정 파일 | 앱 패키지 안 Contents/Eclipse/eclipse.ini |
Eclipse IDE 메모리 늘리는 법
Eclipse IDE는 기본으로 자바 힙 메모리를 1024MB까지 씁니다. 플러그인이 많거나 파일이 많아 OutOfMemoryError가 나면 -vmargs -Xmx 값을 1024M보다 크게 줘서 늘립니다. -vmargs 는 다른 이클립스 인자보다 뒤에 와야 합니다. 공식 문서는 실제 메모리에 가깝거나 더 크게 잡으면 가상 메모리를 오가며 오히려 크게 느려진다고 적고 있습니다.
Eclipse IDE 워크스페이스 업그레이드 주의
새 판으로 워크스페이스를 한 번 열면 업그레이드되고, 그 뒤로는 옛 판에서 그 워크스페이스를 쓸 수 없습니다. 공식 문서는 워크스페이스를 설치 폴더 밖의 빈 곳에 복사해 두고, 새 판은 옛 판과 다른 새 폴더에 설치하라고 안내합니다. 옛 판에 추가로 깔았던 플러그인은 새 판에 다시 설치해야 합니다.
Eclipse IDE를 처음 받는다면 최신판 2026-09의 설치 프로그램을 운영체제에 맞게 고르면 됩니다. 2026-09판은 설치 프로그램과 패키지에 JRE가 들어 있고, 윈도우용은 x86_64와 AArch64뿐이라 32비트 윈도우에서는 쓸 수 없습니다. 자바 개발만 한다면 360MB짜리 Java Developers 패키지가 가장 가볍습니다. 실행이 안 되면 자바 버전(최소 Java SE 21)과 설치 경로의 특수문자, 이전 판 폴더에 덮어 설치했는지를 먼저 봅니다. 새 판으로 올릴 때는 워크스페이스를 먼저 복사해 두고 새 폴더에 설치해야 옛 판으로 돌아갈 길이 남습니다. 업데이트는 Help → Check for Updates, 플러그인 설치는 Install New Software 나 Eclipse Marketplace 로 합니다.
