[맥북 자바 환경설정 #2]

스프링 부트 프로젝트 환경 세팅을 JDK 21 기준으로 완전 정리하였고, JDK, SDK, JVM, JAVA_HOME, Gradle 의 핵심 개념을 정리하였습니다.
도경원's avatar
Aug 01, 2025
[맥북 자바 환경설정 #2]

1. 스프링 부트 프로젝트 환경 세팅 완전 정리 (JDK 21 기준)

1.1 목표

어떤 프로젝트를 git clone해서 받아와도 ./gradlew bootRun만 하면 바로 실행되도록 세팅.

1.2 시스템에 JDK 21 설치 및 고정

(1) 설치

brew install openjdk@21

(2) .zshrc 또는 .bash_profile에 아래 추가

export JAVA_HOME="/opt/homebrew/opt/openjdk@21" export PATH="$JAVA_HOME/bin:$PATH"

(3) 적용

source ~/.zshrc # 또는 source ~/.bash_profile

(4) 확인

java -version # → 21.0.8 이상 echo $JAVA_HOME # → /opt/homebrew/opt/openjdk@21

1.3 IntelliJ 설정 고정

(1) Project SDK 설정

  • 단축키: ⌘ + ;
  • Project SDK: JDK 21 선택
  • Language Level: SDK default (21)

(2) Gradle JVM 설정

  • 단축키: ⌘ + , → Preferences
  • 메뉴: Build Tools > Gradle
  • Gradle JVM: JDK 21 선택

1.4 프로젝트 설정 확인 (build.gradle)

build.gradle에 아래 내용이 포함돼야 함:
java { toolchain { languageVersion = JavaLanguageVersion.of(21) }
  • 설정이 없다면 추가
  • 이미 있다면 21로 되어 있는지 확인

1.5 프로젝트 clone 받은 후 해야 할 일

git clone [레포지토리 주소] cd 프로젝트명 chmod +x ./gradlew # 한 번만 해주면 됨 ./gradlew --version # JVM이 Java 21인지 확인 ./gradlew clean build # 전체 빌드 ./gradlew bootRun # 실행
  • 서버 종료는 Ctrl + C
  • 포트 충돌 시 lsof -i :8080kill -9 [PID]

1.6 문제가 생겼을 때 체크포인트

확인 항목
명령어
JDK 버전 확인
java -version
Gradle이 사용하는 JVM 확인
./gradlew --version
서버 실행 중인지 확인
lsof -i :8080
실행 중인 서버 종료
Ctrl + C 또는 kill -9 PID

2. 핵심 개념 정리 (JDK, SDK, JVM, JAVA_HOME, Gradle)

2.1 JDK (Java Development Kit)

  • 자바 개발에 필요한 모든 도구 모음
  • 컴파일러(javac), 실행기(java), 디버거 등 포함
  • Java 21, Java 17 등으로 버전 구분
  • JDK가 있어야 코드를 만들고 실행할 수 있음

2.2 JVM (Java Virtual Machine)

  • 자바 프로그램을 실행해주는 엔진
  • .class 바이트코드를 실행함
  • OS에 상관없이 자바가 돌아가는 이유는 JVM 덕분
  • JDK 안에 JVM이 포함되어 있음

2.3 SDK (Software Development Kit)

  • 어떤 플랫폼에서 개발하기 위한 도구 세트
  • JDK도 SDK의 일종 (Java SDK)
  • Android SDK, AWS SDK 같은 것들도 있음
  • 즉, SDK는 JDK보다 더 큰 개념

2.4 JAVA_HOME

  • "우리 컴퓨터에서 자바가 어디 있냐"를 알려주는 환경 변수
  • Gradle, IntelliJ 등이 이 경로를 참고해서 어떤 자바를 쓸지 결정함
  • 잘못 설정되면 실행 시 JDK 버전 충돌로 에러 발생

2.5 Gradle

  • 자바 프로젝트 빌드 자동화 도구
  • 컴파일, 테스트, 실행 등을 자동으로 처리
  • build.gradle 파일로 라이브러리, 빌드 설정 등을 관리
  • ./gradlew build, ./gradlew bootRun 같은 명령어로 동작

3. 전체 개념 요약 (비유로 정리)

개념
역할 또는 비유 설명
JDK
자바 개발자용 공구 세트
JVM
자바 프로그램 돌려주는 엔진
SDK
특정 기술/환경에서 개발할 수 있는 도구 모음
JAVA_HOME
자바가 어디 설치되어 있는지 알려주는 주소표
Gradle
자바 프로젝트 자동 조립/실행 로봇

 
Share article

Gyeongwon's blog