Maven 설치 완벽 가이드 - Windows, Mac, Linux에서 Maven 설치하기

Java 개발자라면 반드시 알아야 할 빌드 도구, Apache Maven! 오늘은 Windows, Mac, Linux 각 운영체제별로 Maven을 설치하는 방법을 상세히 알아보겠습니다. Maven은 프로젝트 빌드, 의존성 관리, 문서화를 자동화하는 강력한 도구로, Java 개발 생태계에서 필수적인 위치를 차지하고 있습니다.

Maven 설치 전 필수 요구사항

Maven을 설치하기 전에 반드시 확인해야 할 사항이 있습니다:

Java Development Kit (JDK) 설치
- Maven 3.9.9 (최신 안정화 버전)은 JDK 8 이상을 요구합니다
- JAVA_HOME 환경 변수가 설정되어 있어야 합니다
- java -version 명령어로 Java 설치 확인
시스템 요구사항
- 약 10MB의 디스크 공간 (Maven 자체)
- 로컬 Maven 저장소를 위한 추가 공간 (최소 500MB 권장)

Windows에서 Maven 설치하기

1. Maven 다운로드

Apache Maven 공식 사이트에서 최신 버전 다운로드
Binary zip 아카이브 선택 (예: apache-maven-3.9.9-bin.zip)

2. Maven 설치 및 환경 변수 설정

# 1. 다운로드한 파일을 원하는 위치에 압축 해제 (예: C:\Program Files\Apache\)

# 2. 시스템 환경 변수 설정
- 시작 메뉴에서 "환경 변수" 검색
- "시스템 환경 변수 편집" 클릭
- "환경 변수" 버튼 클릭

# 3. 새 시스템 변수 추가
- 변수 이름: M2_HOME
- 변수 값: C:\Program Files\Apache\apache-maven-3.9.9

# 4. Path 변수 수정
- Path 변수 선택 후 "편집" 클릭
- "새로 만들기" 클릭
- %M2_HOME%\bin 추가

3. 설치 확인

# 명령 프롬프트 열기
mvn -version

# 출력 예시:
Apache Maven 3.9.9 (8e8579a9e76f7d015ee5ec7bfcdc97d260186937)
Maven home: C:\Program Files\Apache\apache-maven-3.9.9
Java version: 17.0.2, vendor: Oracle Corporation

macOS에서 Maven 설치하기

방법 1: Homebrew 사용 (추천)

# Homebrew가 설치되어 있지 않다면 먼저 설치
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Maven 설치
brew install maven

# 설치 확인
mvn -version

방법 2: 수동 설치

# 1. Maven 다운로드
curl -O https://downloads.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz

# 2. 압축 해제
tar xzvf apache-maven-3.9.9-bin.tar.gz

# 3. 설치 디렉토리로 이동
sudo mv apache-maven-3.9.9 /opt/

# 4. 환경 변수 설정 (zsh 사용 시)
echo 'export M2_HOME=/opt/apache-maven-3.9.9' >> ~/.zshrc
echo 'export PATH=$M2_HOME/bin:$PATH' >> ~/.zshrc

# 5. 설정 적용
source ~/.zshrc

# 6. 설치 확인
mvn -version

Linux에서 Maven 설치하기

Ubuntu/Debian 계열

# 방법 1: apt 패키지 매니저 사용
sudo apt update
sudo apt install maven

# 설치 확인
mvn -version

수동 설치 (모든 Linux 배포판)

# 1. Maven 다운로드
wget https://downloads.apache.org/maven/maven-3/3.9.9/binaries/apache-maven-3.9.9-bin.tar.gz

# 2. 압축 해제
tar xzvf apache-maven-3.9.9-bin.tar.gz

# 3. 설치 디렉토리로 이동
sudo mv apache-maven-3.9.9 /opt/

# 4. 환경 변수 설정
echo 'export M2_HOME=/opt/apache-maven-3.9.9' >> ~/.bashrc
echo 'export PATH=$M2_HOME/bin:$PATH' >> ~/.bashrc

# 5. 설정 적용
source ~/.bashrc

# 6. 설치 확인
mvn -version

설치 후 초기 설정

1. settings.xml 파일 설정

Maven 설정 파일은 두 곳에 위치할 수 있습니다:

전역 설정: ${M2_HOME}/conf/settings.xml
사용자 설정: ${user.home}/.m2/settings.xml

2. 프록시 설정 (필요한 경우)

<settings>
  <proxies>
    <proxy>
      <id>example-proxy</id>
      <active>true</active>
      <protocol>http</protocol>
      <host>proxy.example.com</host>
      <port>8080</port>
      <username>proxyuser</username>
      <password>proxypass</password>
      <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
    </proxy>
  </proxies>
</settings>

3. 로컬 저장소 위치 변경 (선택사항)

<settings>
  <localRepository>/path/to/local/repo</localRepository>
</settings>

설치 확인 및 문제 해결

일반적인 문제와 해결방법

'mvn'은(는) 내부 또는 외부 명령... 오류
- PATH 환경 변수에 Maven bin 디렉토리가 제대로 추가되었는지 확인
- 터미널/명령 프롬프트를 재시작
JAVA_HOME이 설정되지 않음
- JAVA_HOME 환경 변수가 JDK 설치 디렉토리를 가리키는지 확인
- echo %JAVA_HOME% (Windows) 또는 echo $JAVA_HOME (Mac/Linux)로 확인
버전 충돌 문제
- 여러 버전의 Maven이 설치된 경우 PATH 우선순위 확인
- which mvn (Mac/Linux) 또는 where mvn (Windows)로 실행 경로 확인

마무리

이제 Maven 설치가 완료되었습니다! Maven은 Java 프로젝트의 빌드와 의존성 관리를 획기적으로 간소화해주는 강력한 도구입니다. 설치 후에는 mvn archetype:generate 명령어로 새 프로젝트를 생성하거나, 기존 프로젝트에서 mvn clean install로 빌드를 시작할 수 있습니다.