SDKMAN의 핵심은 **“설치(Install) -> 전환(Switch) -> 확인(Check)”**의 흐름입니다. 가장 자주 쓰는 명령어 위주로 깔끔하게 정리해 드리겠습니다.
1. 설치 가능한 버전 목록 보기 (list)
먼저 어떤 버전을 설치할 수 있는지 확인해야 합니다.
sdk list java
- 화면 조작: 목록이 길게 나옵니다.
Space(다음 페이지),Enter(한 줄 아래),q(나가기) 키를 기억하세요. - 식별자(Identifier): 맨 오른쪽 열에 있는 텍스트가 중요합니다. (예:
24-open,17.0.10-tem등) 설치할 때 이 이름을 사용합니다.
2. 버전 설치하기 (install)
원하는 버전의 식별자(Identifier)를 입력하여 설치합니다.
# 최신 OpenJDK 24 설치
sdk install java 24-open
# Java 17 (LTS) 설치 - Temurin 배포판
sdk install java 17.0.10-tem
- 설치 중 “Do you want to set this version as default? (Y/n)” 라고 물으면:
Y: 이 버전을 시스템 기본값으로 고정합니다.n: 설치만 하고, 기본값은 바꾸지 않습니다.
3. 버전 바꾸기 (use vs default)
이 부분이 SDKMAN의 가장 강력한 기능입니다. 상황에 따라 두 가지 명령어를 구분해서 쓰세요.
A. 현재 터미널에서만 잠깐 바꿀 때 (use)
터미널 창을 닫으면 효력이 사라집니다. 테스트할 때 유용합니다.
sdk use java 17.0.10-tem
B. 영구적으로 기본값을 바꿀 때 (default)
터미널을 껐다 켜도 계속 이 버전이 유지됩니다.
sdk default java 24-open
4. 현재 상태 확인 (current)
지금 내가 어떤 버전을 쓰고 있는지, 어떤 버전들이 설치되어 있는지 확인합니다.
# 현재 활성화된 버전 확인
sdk current java
# 설치된 모든 버전 목록 확인 (목록 중 '*' 표시가 현재 사용 중인 버전)
sdk list java
5. 버전 삭제하기 (uninstall)
더 이상 안 쓰는 버전은 지워서 용량을 확보하세요.
sdk uninstall java 17.0.10-tem
꿀팁: Java 외의 도구도 설치 가능
SDKMAN은 Java(JDK)뿐만 아니라 빌드 도구(Gradle, Maven)나 프레임워크(Spring Boot CLI)도 똑같이 관리해 줍니다.
# Gradle 설치
sdk install gradle
# Maven 설치
sdk install maven
버전 관리가 꼬이기 쉬운 Gradle, Maven도 SDKMAN으로 관리하면 프로젝트별로 버전을 쉽게 바꿀 수 있어 매우 편리합니다.
요약 (Cheat Sheet)
| 기능 | 명령어 | 비고 |
|---|---|---|
| 목록 보기 | sdk list java |
q로 종료 |
| 설치 | sdk install java [식별자] |
예: 24-open |
| 잠깐 쓰기 | sdk use java [식별자] |
현재 창 닫으면 초기화 |
| 기본 설정 | sdk default java [식별자] |
영구 변경 |
| 현재 버전 | sdk current java |
|
| 삭제 | sdk uninstall java [식별자] |