Eclipse 설치와 Workspace 설정 - Encoding, JDK, Tomcat까지

원본 작성일: 2014년경
보완 작성일: 2026.02.14

Eclipse를 설치하고 Java 웹 개발을 위한 기본 환경을 셋팅하는 과정이다. 원본은 Eclipse Kepler(4.3.2) 기준이지만, 설정 항목 자체는 최신 버전에서도 거의 동일하다.

2026년 기준: Eclipse는 3개월 주기로 릴리스되고 있다 (현재 2025-xx 버전). Java 웹 개발은 IntelliJ IDEA가 점유율을 많이 가져갔지만, Eclipse는 여전히 무료 + 플러그인 생태계라는 장점이 있다.

1. Eclipse 다운로드

Eclipse 공식 사이트에서 Eclipse IDE for Enterprise Java and Web Developers를 다운로드한다.

예전에는 "Java EE Developers"라는 이름이었는데, 지금은 "Enterprise Java and Web Developers"로 바뀌었다. Java 웹 개발이 목적이면 이 패키지를 선택한다.

2. 설치

다운로드한 파일의 압축을 풀고 원하는 경로에 놓는다.

C:\Program Files\eclipse    (Windows)
/Applications/Eclipse.app   (macOS)

3. Workspace 설정

Eclipse 첫 실행 시 Workspace 경로를 묻는다. 프로젝트 파일이 저장될 폴더다.

C:\workspace    (Windows)
~/workspace     (macOS/Linux)

팁: 프로젝트마다 Workspace를 분리하면 설정 충돌을 피할 수 있다.

4. 필수 설정

4.1 Encoding → UTF-8

한글 깨짐 방지를 위해 반드시 UTF-8로 설정한다.

Window → Preferences → General → Workspace

• Text file encoding: UTF-8

Window → Preferences → Web

• CSS Files → Encoding: UTF-8
• HTML Files → Encoding: UTF-8
• JSP Files → Encoding: UTF-8

이 설정을 안 하면 소스 파일마다 인코딩이 달라져서 나중에 한글이 깨지는 문제가 생긴다.

4.2 JDK 등록

Window → Preferences → Java → Installed JREs

• Add → Standard VM → JDK 설치 경로 지정

Eclipse는 기본적으로 JRE를 잡는데, 개발에는 JDK가 필요하다. JDK 경로를 명시적으로 등록하고 기본값으로 체크한다.

4.3 Tomcat 등록 (웹 프로젝트)

Window → Preferences → Server → Runtime Environments

• Add → Apache Tomcat 선택 → 설치 경로 지정

이렇게 해야 Eclipse에서 웹 프로젝트를 Run As → Run on Server로 실행할 수 있다.

4.4 Maven 설정 (선택)

Maven + Eclipse 기본 셋팅에서 상세히 다룬다.

설정 체크리스트

설정	경로	필수
Encoding UTF-8	General → Workspace	O
Web Encoding UTF-8	Web → CSS/HTML/JSP	O
JDK 등록	Java → Installed JREs	O
Tomcat 등록	Server → Runtime Environments	웹 프로젝트 시
Maven 연동	Maven → User Settings	Maven 사용 시

관련 글:

• Eclipse에서 Lombok 설치하고 사용하기
• Eclipse에서 jQuery 오류 표시 제거하기