Maven + Eclipse 기본 셋팅 - 환경변수부터 플러그인까지

원본 작성일: 2013.05.09
보완 작성일: 2026.02.14

Windows 환경에서 Maven을 설치하고 Eclipse와 연동하는 과정을 정리한 글이다.

2026년 기준: 최신 Eclipse(2020+)는 Maven 플러그인(m2e)이 기본 내장되어 있다. 별도 플러그인 설치 없이 Maven 프로젝트를 바로 import할 수 있다. 아래 플러그인 설치 단계는 Eclipse Kepler 이전 버전에 해당한다.

1. Maven 다운로드 및 설치

Maven 설치 가이드에서 다운로드, 압축 해제, 환경변수 설정을 다룬다.

설치 확인:

mvn -version

2. settings.xml 수정

[maven 설치 경로]/conf/settings.xml

<!-- 로컬 저장소 경로 변경 (기본값: ~/.m2/repository) -->
<localRepository>D:\maven\repository</localRepository>

localRepository는 Maven이 다운로드한 jar 파일을 저장하는 위치다. 기본값은 사용자 홈 디렉토리의 .m2/repository인데, 경로를 바꾸고 싶으면 여기서 수정한다.

3. Eclipse 플러그인 설치 (구버전)

아래는 Eclipse Kepler 이전 버전 기준이다. Eclipse Luna(2014.6) 이후는 m2e가 기본 포함되어 있으므로 이 단계를 건너뛰면 된다.

1. Help → Install New Software
2. Add 클릭
3. 다음 URL 입력:
   • http://m2eclipse.sonatype.org/sites/m2e
   • http://m2eclipse.sonatype.org/sites/m2e-extras
4. 설치 후 Eclipse 재시작

4. Eclipse에서 Maven 설정 연결

1. Window → Preferences → Maven → User Settings
2. User Settings에 settings.xml 경로 지정
3. Local Repository가 자동으로 localRepository 값으로 채워진다

5. Eclipse 실행 오류 시

JDK 경로를 못 찾는 경우 eclipse.ini에 추가:

-vm
C:\Program Files\Java\jdk1.8.0_xxx\bin\

지금은?

항목	2014년	현재
Maven 플러그인	수동 설치	Eclipse 내장
Maven 버전	3.0.5	3.9.x
설정	settings.xml 직접 수정	동일
대안	없음	IntelliJ (Maven 완벽 지원)