본문 바로가기

개발Blog

VS Code에서 Maven 설정하는 방법

반응형

Java 개발을 하다 보면 빌드 자동화 도구가 필요할 때가 많아요. 특히 Maven은 프로젝트의 라이브러리 관리와 빌드 과정을 편리하게 해주는 도구인데요. 이번 글에서는 VS Code에서 Maven을 설정하는 방법을 하나씩 살펴볼게요. 😊


1. VS Code에 Maven 확장 프로그램 설치하기

먼저, VS Code에서 Maven을 제대로 활용하려면 Maven for Java 확장 프로그램을 설치해야 해요.

설치 방법

  1. VS Code를 실행하고 왼쪽 사이드바의 확장(Extensions) 아이콘을 클릭해요.
  2. 검색창에 Maven for Java를 입력하고 나온 결과에서 Maven for Java를 선택한 뒤 설치(Install) 버튼을 눌러요.
  3. 설치가 끝나면 VS Code를 재시작하면 돼요.

이제 Maven을 사용할 준비가 거의 끝났어요! 😊 다음은 Maven을 제대로 활용할 수 있도록 환경 변수를 설정해볼게요.


2. Maven 환경 변수 설정하기

Maven을 사용하려면 시스템 환경 변수에 MAVEN_HOME을 등록해야 해요. 아래 순서대로 따라 해보세요!

Windows에서 설정하는 방법

  1. Maven 다운로드: Apache Maven 공식 사이트에서 최신 버전을 다운로드하고, 적절한 폴더에 압축을 풀어요.
  2. 환경 변수 설정:
    • Windows 검색창에 환경 변수 편집을 입력하고 실행해요.
    • 시스템 변수에서 새로 만들기 버튼을 누르고
      • 변수 이름: MAVEN_HOME
      • 변수 값: Maven이 설치된 경로 (예: C:\apache-maven-3.8.6)
    • Path 변수를 선택한 후 편집을 클릭하고, 새 항목을 추가해요.
      • C:\apache-maven-3.8.6\bin을 추가하면 돼요.
  3. 적용 확인: cmd 창을 열고 아래 명령어를 입력해보세요.Maven 버전이 제대로 출력되면 성공이에요! 🎉
  4. mvn -version

Mac 및 Linux에서 설정하는 방법

  1. Homebrew를 이용해 Maven 설치하기
  2. brew install maven
  3. 설치 확인위 명령어를 실행했을 때 Maven 버전이 출력되면 설정이 완료된 거예요!
  4. mvn -version

3. VS Code에서 Maven 프로젝트 생성하기

이제 Maven 프로젝트를 직접 만들어볼게요! VS Code에서 터미널을 열고 아래 명령어를 입력하면 돼요.

mvn archetype:generate -DgroupId=com.example -DartifactId=MyMavenProject -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

위 명령어는 MyMavenProject라는 기본적인 Java 프로젝트를 생성하는 명령어예요. 프로젝트가 생성되면 VS Code에서 파일 > 폴더 열기를 선택해서 MyMavenProject 폴더를 열어보세요.


4. Maven 명령어 사용해보기

Maven을 사용하면 프로젝트 빌드, 테스트, 실행을 쉽게 할 수 있어요. 자주 쓰이는 명령어 몇 가지를 소개할게요.

  • 프로젝트 빌드:프로젝트를 빌드하고 필요한 라이브러리를 다운로드해요.
  • mvn clean install
  • 프로젝트 실행:com.example.App에 해당하는 메인 클래스를 실행해요.
  • mvn exec:java -Dexec.mainClass="com.example.App"
  • 테스트 실행:프로젝트 내의 테스트 코드를 실행해요.
  • mvn test

마무리하며

이제 VS Code에서 Maven을 설정하고 활용하는 방법을 익혔어요! 🎉 앞으로 Maven을 사용하면 프로젝트의 라이브러리를 편하게 관리하고, 빌드와 실행을 손쉽게 할 수 있을 거예요. 혹시 더 궁금한 점이 있으면 댓글로 남겨주세요! 😊

'개발Blog' 카테고리의 다른 글

VS Code에서 Spring Boot 설정하는 방법  (0) 2025.02.09