Mac OS에서 Spring Boot 개발환경 구축하기

개요

본 게시글에서는 Mac 환경에서 Spring Boot 개발을 시작하기 위한 환경 구축 과정을 다룹니다.
사용 도구는 VSCode, Homebrew, JDK 21, Gradle입니다.

---

1. Homebrew 설치

Homebrew는 Mac OS의 패키지 매니저로, 개발에 필요한 도구들을 터미널에서 간편하게 설치할 수 있게 해줍니다.

먼저 터미널을 열고 아래 명령어를 실행합니다.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 완료 후 터미널에 출력되는 안내 문구에 따라 아래 명령어를 반드시 실행해야 하는데, 실행하지 않으면 brew 명령어를 인식할 수 없으니 반드시 실행해야 합니다.

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

---

2. JDK 21 설치

JDK(Java Development Kit)는 Java 애플리케이션을 컴파일하고 실행하기 위해 필요한 도구 모음으로서
Spring Boot 3.x 버전은 JDK 17 이상을 요구하므로, 본 게시글에서는 최신 LTS 버전인 JDK 21을 설치합니다.

brew install openjdk@21

설치 후 JDK 경로를 시스템에 연결합니다.

sudo ln -sfn /opt/homebrew/opt/openjdk@21/libexec/openjdk.jdk /Library/Java/JavaVirtualMachines/openjdk-21.jdk

설치 확인

java -version

아래와 같이 출력되면 정상적으로 설치된 것입니다.

openjdk version "21.x.x" ...

---

3. VSCode 확장 프로그램 설치

VSCode에서 Java 및 Spring Boot 개발을 위해 아래 4가지 확장 프로그램을 설치합니다.

확장 프로그램	용도
Extension Pack for Java	Java 개발 필수 패키지 (자동완성, 디버깅 등)
Spring Boot Extension Pack	Spring Boot 지원
Gradle for Java	빌드 도구 연동
GitLens	Git 시각화

설치 방법: VSCode 좌측 사이드바의 확장 아이콘 클릭 → 각 이름 검색 후 설치

참고: 확장 프로그램 설치 후 자동으로 뜨는 환영 탭(Get Started 등)은 무시하고 닫아도 무방합니다.

---

4. 첫 Spring Boot 프로젝트 생성

cmd + shift + P → Spring Initializr: Create a Gradle Project 실행 후 아래와 같이 설정

항목	값
Spring Boot 버전	3.x.x 최신 (SNAPSHOT 제외)
언어	Java
Group	com.example
Artifact	demo
Packaging	Jar
Java 버전	21
Dependencies	Spring Web

저장 폴더 선택 후 프로젝트가 생성되면 우측 하단의 Open 버튼을 클릭해 프로젝트를 열어주세요.

---

5. 서버 실행

DemoApplication.java 파일을 열면 코드 상단에 Run | Debug 텍스트가 표시되는데,
Run 을 클릭하면 서버가 실행됩니다.

터미널에 아래 문구가 출력되면 정상적으로 실행된 것입니다.

Started DemoApplication in x.xxx seconds

브라우저에서 http://localhost:8080 에 접속했을 때 Whitelabel Error Page 가 표시되면 정상적으로 작동하는 것으로,
아직 아무 페이지도 구현하지 않았기 때문에 에러 페이지가 표시되는 것이 정상입니다.

---

6. 자동 재시작 설정 (spring-boot-devtools)

코드를 수정할 때마다 서버를 수동으로 재시작하지 않도록 spring-boot-devtools 를 추가.
build.gradle 의 dependencies 블록에 아래 한 줄을 추가합니다.

developmentOnly 'org.springframework.boot:spring-boot-devtools'

이후 파일을 저장(cmd + S)하면 자동으로 서버가 재시작됩니다.

---

마무리

이로써 Mac 환경에서 Spring Boot 개발을 시작하기 위한 기본 환경 구축을 끝냈습니다.
다음 글에서는 실제 REST API를 구현하는 과정을 다루겠습니다.

 

감사합니다.