[VsCode] Maven 및 MAVEN_HOME 설정하기

0. 사전 세팅 및 점검

JDK 및 JAVA_HOME 환경변수, Path 점검

 

https://jdk.java.net/archive/

 

Archived OpenJDK GA Releases

Archived OpenJDK General-Availability Releases This page is an archive of previously released builds of the JDK licensed under the GNU General Public License, version 2, with Classpath Exception. WARNING: These older versions of the JDK are provided to he

jdk.java.net

 

 

 

Downloads for Amazon Corretto 17 - Amazon Corretto 17

 

위와 같은 곳 혹은 구글 검색을 통해 원하는 JDK 버전을 설치한다.

또는 설치 (설치되면 자동으로 JAVA_HOME을 추가되는데, 안되면 환경변수 편집하여 추가해줄 것)

 

시스템 환경 변수 편집 > 환경변수 > 새로 만들기 > 변수이름 JAVA_HOME  / 변수 값에는 JDK 설치경로

Path 추가 %JAVA_HOME%\bin;

 

설치 후 cmd 또는 PowerShell 을 통해 아래 명령어를 치게되면 설치된 JAVA 버전을 알 수 있다.

java -version
javac -version

 

1. Maven 설치 및 MAVEN_HOME 환경변수 추가

  • Maven이 설치되어 있는지 확인
  • 공식 다운로드에서 Binary zip archive 받기 → 압축 풀기
    • 예: C:\apache-maven-3.9.9
  • MAVEN_HOME 환경변수 추가 ( MAVEN_HOME = C:\apache-maven-3.9.9 )
  • Path 추가 %MAVEN_HOME%\bin
  • 최종적으로 cmd 또는 PowerShell에서 " mvn-version " 을 통해 확인

 

2. Vs Code 내 Extension 추가

 

Maven for Java - Visual Studio Marketplace

 

Maven for Java - Visual Studio Marketplace

Extension for Visual Studio Code - Manage Maven projects, execute goals, generate project from archetype, improve user experience for Java developers.

marketplace.visualstudio.com

 

 


🚨 자주 하는 실수

  • JAVA_HOME을 JRE 경로(C:\Program Files\Java\jre...)로 잡음 ❌
  • Path에 bin이 빠져 있음 ❌
  • 환경 변수 변경 후 기존 cmd 창에서 그대로 실행 (반드시 새 창 열어야 적용됨) ❌

 

3. Maven 정리

특징

  • XML 기반 설정 (pom.xml)
    모든 빌드 로직과 의존성을 XML로 선언.
  • Convention over Configuration
    프로젝트 구조와 빌드 방식에 일관된 규칙을 강제 → 진입 장벽이 낮음.
  • Plugin 중심
    다양한 플러그인 제공 (예: maven-compiler-plugin, maven-surefire-plugin).
  • 넓은 생태계
    오랫동안 사용되어 문서, 예제, StackOverflow 답변 풍부.

장점

  • 표준화된 구조와 프로세스 → 협업 시 일관성 높음.
  • 풍부한 플러그인과 레퍼런스.
  • 안정적이고 검증된 도구 (대규모 기업에서도 여전히 많이 사용).

단점

  • XML 설정 다중화 → 복잡한 빌드 로직은 유지보수가 어려움.
  • 빌드 속도 느림 (특히 큰 프로젝트).
  • DSL(도메인 특화 언어) 부재 → 유연한 커스터마이징이 어려움.