Windows 환경에서 Spring Tool Suite 4(STS 4) 완벽 설치 가이드

Spring Framework 기반 개발을 위한 필수 도구, Spring Tool Suite 4(이하 STS 4)의 설치 방법을 찾고 계시나요? 이 포스팅에서는 Windows 환경에서 STS 4를 완벽하게 설치하는 전체 과정을 이미지 없이도 이해할 수 있도록 단계별로 자세히 안내합니다. 초보자도 따라할 수 있는 쉬운 설명과 함께, 설치 중 발생할 수 있는 문제에 대한 해결 팁도 함께 정리해 드립니다.

---

✅ STS란 무엇인가요?

**Spring Tool Suite (STS)**는 Spring 기반 애플리케이션 개발을 위한 통합 개발 도구(IDE)입니다. Eclipse를 기반으로 하며, Spring 프로젝트를 보다 쉽게 생성하고 관리할 수 있도록 다양한 플러그인과 툴을 제공합니다. 주요 기능은 다음과 같습니다:

• Spring Boot 프로젝트 자동 생성 및 템플릿 제공
• Gradle, Maven 빌드 툴 통합
• Spring Initializr UI 지원
• 코드 자동 완성, 디버깅, 테스트 지원
• 다양한 플러그인 연동 (Lombok, DevTools 등)

📝 참고: Spring Boot 프로젝트를 효율적으로 개발하고자 한다면 STS는 매우 유용한 도구입니다. 특히 초보 개발자에게는 복잡한 설정 없이 개발을 시작할 수 있는 최적의 IDE입니다.

---

🔽 STS 설치 파일 다운로드하기

1. 공식 사이트 접속

먼저 아래 링크를 클릭하여 STS 공식 다운로드 페이지로 접속합니다:

👉 https://spring.io/tools

2. 설치 파일 선택

페이지에 접속하면 여러 버전의 STS 다운로드 링크가 나타납니다. 이 중에서 Windows 사용자라면 "Spring Tools 4 for Eclipse - Windows" 항목을 선택하면 됩니다.

파일명 예시:

spring-tool-suite-4-4.23.1.RELEASE-e4.32.0-win32.win32.x86_64.self-extracting.jar

🔍 버전 번호와 파일 이름은 업데이트 시 달라질 수 있습니다. 최신 버전을 다운로드하세요.

3. 다운로드 진행

해당 파일을 클릭하면 .jar 확장자를 가진 설치 실행 파일이 다운로드됩니다.

---

📦 STS 설치(압축 해제) 과정

STS 설치 파일은 일반적인 설치 프로그램이 아니라 자체 압축 해제 방식으로 작동합니다. 다음 단계를 차근차근 따라 하세요.

1. 명령어로 JAR 파일 실행

다운로드한 .jar 파일을 실행하기 위해서는 JDK가 설치되어 있어야 합니다. JDK가 정상적으로 설치되어 있고 java 명령어가 동작하는 환경이라면 아래 명령어로 실행합니다.

java -jar spring-tool-suite-4-4.23.1.RELEASE-....jar

⚠️ 만약 "java는 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다" 라는 오류가 뜬다면 JDK가 설치되어 있지 않거나, 환경변수(PATH)에 Java 경로가 등록되지 않았을 수 있습니다.

2. 자동 압축 해제

위 명령어를 실행하면 압축 해제가 자동으로 진행되며, SpringToolSuite4.exe 파일이 포함된 폴더가 생성됩니다.

3. 설치 완료 확인

압축 해제가 완료된 폴더 내에 다음과 같은 파일 및 폴더가 존재하면 정상적으로 설치된 것입니다.

• SpringToolSuite4.exe
• configuration/, plugins/, features/, readme/ 등 하위 폴더

📂 설치는 따로 셋업 마법사가 없는 구조입니다. 단순히 실행 파일이 포함된 폴더가 만들어지는 방식이므로 압축만 풀어지면 바로 사용 가능합니다.

---

▶️ STS 실행하기

1. 실행 파일 더블 클릭

설치된 폴더로 이동한 후 SpringToolSuite4.exe 파일을 더블 클릭하면 STS가 실행됩니다.

2. 워크스페이스(작업 폴더) 설정

처음 실행 시, "Workspace Launcher" 팝업이 나타납니다. 이곳에서 프로젝트 파일을 저장할 폴더 경로를 설정합니다.

• 기본 경로 사용 가능 (C:\Users\사용자이름\spring-workspace)
• 또는 직접 지정 가능 (예: D:\spring-projects)
• "Use this as the default and do not ask again" 체크 시 다음부터 이 창이 뜨지 않습니다.

3. 실행 완료

워크스페이스를 설정하고 Launch 버튼을 클릭하면 STS의 메인 화면이 열립니다. Eclipse 기반이므로 사용자 인터페이스가 매우 유사합니다.

🧩 참고: 실행 속도가 다소 느릴 수 있으나, 초기 실행 시 캐시 로딩이 포함된 것이므로 걱정하지 않으셔도 됩니다.

---

🛠️ 설치 후 필수 설정 및 팁

1. JDK 버전 확인

STS는 내부적으로 Java 환경이 필요하므로 설치된 JDK 버전과 호환성이 맞는지 확인해야 합니다.

• Window > Preferences > Java > Installed JREs
• JDK 경로가 정확하게 등록되어 있는지 확인

2. Maven, Gradle 연동 확인

Spring 프로젝트에서 자주 사용되는 빌드 툴인 Maven과 Gradle이 연동되어 있는지 확인합니다.

• Window > Preferences > Maven or Gradle
• 필요 시 로컬 설치 경로 등록

3. Lombok 설정

Lombok을 사용하는 프로젝트의 경우, STS에 Lombok 플러그인이 설치되어 있어야 합니다.

java -jar lombok.jar

설치 후 STS를 재시작하면 자동으로 인식됩니다.

---

🧩 설치 오류 및 해결법

❌ 문제 1: JAR 파일 실행이 안됨

오류 메시지: java is not recognized...

해결법: JDK가 설치되어 있지 않거나, 환경 변수에 등록되지 않았을 가능성이 큽니다. Oracle 또는 OpenJDK 사이트에서 JDK를 설치하고, JAVA_HOME 및 PATH를 등록하세요.

---

❌ 문제 2: 실행은 되지만 화면이 멈춤

해결법: 기존 워크스페이스 설정 파일의 충돌일 수 있습니다. STS 실행 시 워크스페이스를 새로 지정하거나 .metadata 폴더를 삭제해보세요.

---

✅ 마무리하며

이제 여러분은 Windows 환경에서 **Spring Tool Suite 4(STS 4)**를 완벽하게 설치하고 실행할 수 있게 되었습니다. STS는 Spring Boot 기반 웹 어플리케이션이나 REST API를 구축할 때 매우 유용하며, 다양한 플러그인과 연동을 통해 강력한 개발 환경을 제공합니다.

---

📌 요약 정리

항목 설명

공식 사이트	https://spring.io/tools
설치 파일 형식	.jar (Self-extracting)
실행 명령어	java -jar <파일명>.jar
설치 방식	압축 해제 후 바로 실행
실행 파일	SpringToolSuite4.exe
필수 조건	Java JDK 설치 및 환경변수 등록