프론트엔드의 Java 환경 셋팅 삽질기😁 (with VSCode + Gradle)

회사 프로젝트에서 프론트 포팅 떠야 해서 Java를 보게 됐다...
그래서 삽질 시작! 기록 안 해두면 다음에 또 멘붕올 것 같아서 블로그에 적어둠ㅠ

1) Java 설치 (feat. Oracle 회원가입 귀찮아도 해야 함)

https://www.oracle.com/kr/java/technologies/downloads

필자 프로젝트는 Java 17을 사용하길래 해당 버전으로 설치함
각자 컴퓨터 OS에 맞는 .dmg, .exe 등 다운받으면 됨

2) 환경변수 등록 – $JAVA_HOME

export JAVA_HOME="/Users/사용자명/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
export PATH="$JAVA_HOME/bin:$PATH"

👉 $JAVA_HOME은 시스템이나 빌드 도구(gradle 등)가 자바 위치를 알 수 있도록 도와주는 환경변수. 없으면 gradle이 자바 못찾고 오류 뿜을 수 있다고함.

3) VSCode 확장 프로그램 설치

자바 개발자처럼 보이기 위한 최소한의 장비템:

• Spring Boot Extension Pack
• Extension Pack for Java

둘 다 마켓플레이스에서 설치하면 된다.

4) 프로젝트 가져오기 (from Git)

• 회사 git 저장소에서 클론해오고 VSCode로 열어준다.

5) 빌드 시도

./gradlew clean build → 그리고 오류 파티 시작 😇

5-1) ./gradlew: Permission denied

맥은 가끔 파일 실행 권한이 없다고 에러뜬다고함. 아래 명령어로 쉽게 해결!

chmod +x ./gradlew

5-2) compileJava FAILED 빌드 에러

error: class MembersMatch is public, should be declared in a file named MembersMatch.java

에러 메시지 보니, 클래스 이름은 MembersMatch인데, 파일 이름이 membersMatch.java로 되어 있었음.

🙃 윈도우에선 대소문자 구분이 안 돼서 백엔드 개발자는 모르고 있었고,
맥에선 철저하게 구분하니까 에러 대폭발🔥

🔧 해결 방법: 파일명들을 클래스명에 맞게 대문자로 고쳐줌

ex) goodsMatch.java → GoodsMatch.java

정리 ✨

• 자바는 설치보다 빌드환경 셋팅과 파일명 규칙이 더 빡셈.
• 맥 쓰는 사람은 대소문자 구분 꼭 신경쓰기.
• Gradle이랑 친해져야 오류 안 무섭다.
• 여전히 자바는 낯설지만… 일단은 돌아가긴 함!

필자처럼 프론트 개발자였는데 갑자기 자바 뚝딱 만져야 되는 분들께 도움 되길 🙌