inblog logo
|
Gyeongwon's blog
    환경설정

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

    스프링 부트 프로젝트 환경 세팅을 JDK 21 기준으로 완전 정리하였고, JDK, SDK, JVM, JAVA_HOME, Gradle 의 핵심 개념을 정리하였습니다.
    도경원's avatar
    도경원
    Aug 01, 2025
    [맥북 자바 환경설정 #2]
    Contents
    1. 스프링 부트 프로젝트 환경 세팅 완전 정리 (JDK 21 기준)1.1 목표1.2 시스템에 JDK 21 설치 및 고정1.3 IntelliJ 설정 고정1.4 프로젝트 설정 확인 (build.gradle)1.5 프로젝트 clone 받은 후 해야 할 일1.6 문제가 생겼을 때 체크포인트2. 핵심 개념 정리 (JDK, SDK, JVM, JAVA_HOME, Gradle)2.1 JDK (Java Development Kit)2.2 JVM (Java Virtual Machine)2.3 SDK (Software Development Kit)2.4 JAVA_HOME2.5 Gradle3. 전체 개념 요약 (비유로 정리)

    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 :8080 → kill -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
    Contents
    1. 스프링 부트 프로젝트 환경 세팅 완전 정리 (JDK 21 기준)1.1 목표1.2 시스템에 JDK 21 설치 및 고정1.3 IntelliJ 설정 고정1.4 프로젝트 설정 확인 (build.gradle)1.5 프로젝트 clone 받은 후 해야 할 일1.6 문제가 생겼을 때 체크포인트2. 핵심 개념 정리 (JDK, SDK, JVM, JAVA_HOME, Gradle)2.1 JDK (Java Development Kit)2.2 JVM (Java Virtual Machine)2.3 SDK (Software Development Kit)2.4 JAVA_HOME2.5 Gradle3. 전체 개념 요약 (비유로 정리)

    Gyeongwon's blog

    RSS·Powered by Inblog