[Setup][WSL][Java] SDKMAN으로 Java 개발 환경 세팅

이 글은 WSL 환경에서 SDKMAN을 사용하여 Java 개발 환경을 세팅하는 방법에 대해 정리한 글입니다.

---

이 글의 목표는

• WSL 환경에서 VSCode를 이용하는 Java 개발 환경 세팅
• VSCode에서 Java + Spring Boot 개발 환경 세팅

이다.

모든 내용은 WSL이 설치되어 있다는 가정하에 설치를 진행한다. 만약 WSL 설치가 궁금하면 WSL 설치 관련 글을 확인하자.

관련글: [Setup][Windows][WSL] 윈도우11에서 WSL(Windows Subsystem for Linux) 설치

[Setup][Windows][WSL] 윈도우11에서 WSL(Windows Subsystem for Linux) 설치

---

세팅 환경

이 글에서 진행하는 환경은 다음과 같다.

• OS : Windows 11 WSL Ubuntu-24.04
• CLI : Ubuntu-24.04 z-shell (bash 쉘 설정 내용도 함께 포함)

---

WSL Ubuntu 기본 준비

진행에 필요한 WSL Ubuntu에서 패키지와 유틸을 먼저 실치한다.

sudo apt update
sudo apt upgrade -y

sudo apt install curl unzip zip git ca-certificates bash-completion build-essential

설치가 완료되었으면, 작업용 디렉터리를 하나 만들어준다.

mkdir -p ~/workspace
cd ~/workspace

---

SDKMAN 설치

SDKMAN은 Java와 Gradle 같은 JVM 계열 도구의 설치, 전환, 기본 버전 관리를 쉽게 해주는 도구이다. Linux, macOS, WSL과 같은 Unix/Linux 계열의 OS를 지원한다.

공식문서: https://sdkman.io/install/

Installation | SDKMAN! the Software Development Kit Manager

 

아래 명령어를 통해 SDKMAN을 설치하고, 현재 실행 중인 쉘에 반영한다.

curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"

설치하고 쉘에 반영까지 마무리했으면, 아래 명령어를 통해 정상적으로 설치되었는지 확인한다. (2026.04.11. 기준 script: 5.22.4, native: 0.7.32)

sdk version

---

SDKMAN으로 JDK 설치

설치 가능한 Java 목록 확인

아래 명령어를 통해 설치 가능한 Java 목록을 확인할 수 있다.

sdk list java

SDKMAN은 여러 벤더의 JDK를 제공하며, 대표적인 벤더는 아래와 같다.

• Eclipse Temurin : 가장 많이 사용하며, 어떤 JDK를 사용할지 모르겠다면 해당 벤더의 JDK를 사용하면 됨
• BellSoft Liberica JDK : Spring Boot의 공식 빌드팩에서 기본 JDK로 사용하는 벤더
• Amazon Corretto : 아마존(AWS)에서 직접 관리하고 패치하는 배포판으로, AWS 서비스와의 궁합이 좋음

이 글에서는 Amazon Corretto의 JDK 21을 설치할 예정이며, 다른 벤더 혹은 다른 버전의 JDK가 필요한 경우에는 sdk list java 명령어에서 확인 가능한 Identifier를 참고해서 필요한 벤더의 JDK 버전을 설치하면 된다.

Amazon Corretto 21 설치

이제 본격적으로 JDK를 설치한다. 아래 명령어로 Amazon Corretto 21 버전을 설치한다.

sdk install java 21.0.10-amzn

설치 중에 기본 값으로 지정할 지 물어보면 필요에 따라 Y를 누르면 되며, 명시적으로 지정할 때에는 아래의 명령어로 지정할 수 있다.

sdk default java 21.0.10-amzn

현재 쉘에서만 임시로 사용할 때에는 아래와 같이 명령어로 지정할 수 있다.

sdk use java 21.0.10-amzn

정상적으로 설치되었는지 확인하기 위해서는 아래 명령어로 확인이 가능하다. (echo $JAVA_HOME에서 아무것도 출력되지 않는다면, 쉘을 다시 실행하고(source ~/.bashrc or source ~/.zshrc) 명령어를 실행하면 경로가 출력된다.)

java -version
javac -version
which java
which javac
echo $JAVA_HOME

---

SDKMAN으로 Gradle 설치

설치 가능한 Gradle 목록 확인

아래 명령어를 통해 설치 가능한 Gradle 목록을 확인할 수 있다.

sdk list gradle

Spring Boot 최신 문서(2026.04.11. 기준) 기준으로 Gradle은 8.14 이상 또는 9.x 버전을 요구한다.

프로젝트에서 사용하는 Gradle 버전에 맞춰서 설치하면 되며, 이번 글에서는 최신 버전인 9.4.1 버전으로 진행한다.

Gradle 설치

아래 명령어로 Gradle을 설치한다. (sdk list gradle 명령어로 지원하는 버전 확인 후 필요한 버전으로 설치)

sdk install gradle 9.4.1

설치가 완료되었다면, 아래 명령어로 기본 값으로 지정한다.

sdk default gradle 9.4.1

만약 현재 쉘에서만 사용하려면, 아래 명령어로 지정한다.

sdk use gradle 9.4.1

정상적으로 설치되었는지 확인할 때에는 아래 명령어를 사용한다. (버전이 뜨지 않는다면, 쉘을 다시 실행하고 명령어를 다시 시도한다.)

gradle -version
sdk current gradle
which gradle