VSCode 환경에서 자바, 메이븐 설정하기

VSCode를 써보신 적이 있으신가요? 마이크로소프트가 밀어주는 오픈소스 코드 에디터인데요. 익스텐션과 생태계 덕분에 엄청 괜찮게 유연성을 확보해주거든요. 타입스크립트, 러스트, 파이썬 작업을 하는 데 쭉 사용해왔는데, 단연코 제가 가장 좋아하는 에디터라고 말할 수 있을 것 같아요.

그런데 문제는 제가 최근에 자바를 배우기 시작했는데, VSCode의 자바 기능이 살짝 불완전한 것으로 악명이 높다는 거예요. 아마 그래서 사람들이 인텔리제이와 같은 기능이 풍부한 IDE(통합 개발 환경)들을 선호할 것 같은데요. 그래도 약간의 설정을 해 주면 꽤 유용하게 사용할 수도 있어요! 제 환경에서는 어떻게 설정했는지 보여드리도록 할게요!

요구사항

이 튜토리얼을 따라오려면 자바와 메이븐이 설치돼 있어야 해요. 설치하려면 아래 링크를 참고해주세요.

• Java Downloads
  • https://www.oracle.com/java/technologies/downloads
• Downloading Apache Maven
  • https://maven.apache.org/download.cgi
  • How to Install Apache Maven on Windows?
    • https://www.geeksforgeeks.org/how-to-install-apache-maven-on-windows/
• 등등…

익스텐션

첫째로, 언어 기능 지원을 위해 익스텐션들을 설치해요.

언어 지원

• Language Support for Java(TM) by Red Hat
  • https://marketplace.visualstudio.com/items?itemName=redhat.java
• Debugger for Java
  • https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-debug
• Project Manager for Java
  • https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-dependency
• Test Runner for Java
  • https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-java-test

패키지 매니저

• Maven for Java
  • https://marketplace.visualstudio.com/items?itemName=vscjava.vscode-maven

포매팅

구글의 스타일 가이드를 설정하는데는 이 포스트가 도움이 됐어요.
https://dev.to/marcushellberg/how-to-configure-vs-code-java-formatting-1p10

사용 예시: 프로젝트 생성

“Maven for Java” 익스텐션을 이용해서 프로젝트를 생성할 수 있어요. 명령어 팔레트에서 “Maven: New Project…“를 실행해주세요.

스프링 프로젝트를 생성하는 경우 “Spring Initializr: Create a Maven Project…“를 대신 실행해보세요.

사용 예시: 종속성 추가

종속성을 추가할 때는 “Maven: Add a dependency…”를 사용해볼 수도 있겠지만, 저는 메이븐 리포지토리를 더 선호해요.
메이븐 리포지토리 웹사이트에서 간단하게 찾는 종속성의 이름을 검색해줄수 있어요.

버전을 선택하고…

종속성의 정의를 pom.xml 파일에 복사-붙여놓기 해줄게요.

Yes나 Always를 적당히 눌러주세요! Always를 선택하면 “.vscode/settings.json” 파일이 업데이트 돼요.

사용 예시: 코드 실행

코드를 실행하려면 “Run -> Run Without Debugging“을 클릭해주거나

아니면 이 명령어를 터미널에서 실행해주면 돼요.

mvn exec:java -Dexec.mainClass="완전한-클래스-이름"

* 완전한 클래스 이름의 예: com.mycompany.app.App

이게 다에요! 이제 VSCode에서 작업할 준비가 된거에요! 이 글이 유용했으면 좋겠네요!
추신: 추가로 “Java Projects”를 사이드바에 추가해보세요. 유용한 도구들이 포함돼 있어요.