Gradle: 프로젝트를 STS에 연동하는 가장 쉬운 방법, 예제, 가이드

Gradle 프로젝트를 Spring Tool Suite (STS)에 가져오고 싶은데, 어디서부터 시작해야 할지 막막하신가요? 걱정 마세요! 어렵지 않아요. 지금부터 차근차근 알려드릴게요. 이 글을 따라 하면 어느새 STS에서 Gradle 프로젝트를 세팅하고 바로 개발을 시작할 수 있을 거예요!

개발을 처음 시작한 분도, 경험이 많은 개발자라도 Gradle을 STS에서 제대로 활용하는 법을 알아두면 확실히 편리해요. 복잡한 설명은 빼고, 핵심만 쉽고 재미있게 정리해 드릴 테니 따라와 주세요!

 

---

 

"Gradle 프로젝트를 STS에 연동하는 가장 쉬운 방법"

 

왜 STS에서 Gradle을 써야 할까요?

Spring Tool Suite (STS)는 Spring Boot 및 Spring Framework 개발에 최적화된 IDE예요. 특히 Gradle을 기본적으로 지원하기 때문에, 번거로운 설정 없이 바로 사용할 수 있고, 의존성 관리부터 빌드, 실행까지 간편하게 해결할 수 있어요.

STS에서 Gradle을 사용하면 이런 점이 좋아요:

• 복잡한 설정 없이 바로 시작 가능!
• Gradle 태스크를 IDE에서 바로 실행 가능
• Spring Boot 프로젝트와 완벽한 호환
• 디버깅이 훨씬 쉬움!
• 의존성 추가와 업데이트가 간단함

 

이제 STS에 Gradle 프로젝트를 가져오는 방법을 알아볼까요?

 

---

 

1단계: 실행 중인 서버 먼저 끄기!

가져오기 전에, 혹시 터미널에서 실행 중인 서버가 있다면 먼저 종료해 주세요. 안 그러면 나중에 충돌이 날 수도 있어요!

1. 터미널(또는 명령 프롬프트)을 엽니다.
2. Ctrl + C를 눌러 서버를 종료합니다.
3. 터미널 화면을 정리합니다 (clear - macOS/Linux, cls - Windows).

 

작업하기 전에 깔끔하게 정리해 두면 훨씬 수월하겠죠?

 

---

 

2단계: STS에서 프로젝트 가져오기

서버를 종료했으면 이제 본격적으로 프로젝트를 가져와 봅시다!

1. STS 실행
2. Import 메뉴 열기:
   • File > Import 클릭.
   • 또는 초기 화면에서 Import Projects 선택.
3. Gradle 프로젝트 가져오기:
   • 검색창에 Gradle 입력.
   • Existing Gradle Project 선택 후 Next 클릭.
4. Gradle 프로젝트 찾기:
   • Browse를 클릭해 프로젝트 폴더를 선택하세요.
   • Open을 클릭합니다.
5. 가져오기 완료!:
   • Finish를 눌러 마무리하세요.
   • STS가 프로젝트를 가져오고, Gradle 태스크도 자동으로 불러옵니다.

 

파일이 많으면 시간이 조금 걸릴 수 있으니 여유를 가지고 기다려 주세요!

 

---

 

3단계: 프로젝트 구조 확인하기

프로젝트가 정상적으로 불러와졌는지 확인해 봅시다.

1. Project Explorer에서 프로젝트가 잘 보이는지 체크!
2. build.gradle 파일을 열어 의존성이 정상적으로 로드되었는지 확인
3. Gradle 태스크 보기 열기:
   • Window > Show View > Gradle Tasks 이동.
   • 프로젝트 노드를 확장해서 사용할 수 있는 태스크들을 확인하세요.

 

여기까지 문제없이 진행됐다면 거의 다 끝난 거예요!

 

---

 

4단계: 불필요한 pom.xml 파일 삭제하기 (필요한 경우)

이전 프로젝트가 Maven 기반이었다면, pom.xml 파일이 남아 있을 수도 있어요. 하지만 이제 Gradle을 사용하니 필요 없겠죠? 깔끔하게 정리해 봅시다.

1. 프로젝트 폴더에서 pom.xml 파일 찾기.
2. 마우스 오른쪽 버튼을 눌러 Delete 선택.
3. 삭제를 확인해 프로젝트를 정리합니다.

 

이렇게 불필요한 파일을 제거하면 프로젝트가 더욱 깔끔해집니다!

 

---

 

5단계: STS에서 애플리케이션 실행하기

이제 프로젝트를 실행해 볼까요?

1. Gradle Tasks 열기
2. Application 섹션 확장
3. bootRun 클릭해서 실행!
4. 콘솔 확인하기:
   • 서버가 정상적으로 시작되었는지 확인하세요.

여기까지 진행하면 거의 다 된 거나 마찬가지예요!

 

---

 

6단계: 웹 브라우저에서 애플리케이션 확인하기

마지막 단계입니다! 프로젝트가 잘 실행되는지 확인해 봅시다.

1. 웹 브라우저 실행
2. 주소창에 http://localhost:8080 입력 후 접속!
3. 페이지가 정상적으로 뜨는지 확인
4. 쿠폰 코드 변경 테스트하기:
   • 쿠폰 코드를 SUPER SALE 같은 걸로 바꿔 보세요.
   • 변경 사항이 정상적으로 반영되는지 확인하세요.

 

잘 작동하면 축하합니다! 프로젝트 가져오기에 성공하셨어요! 🎉

 

---

 

마무리!

이제 STS에서 Gradle 프로젝트를 가져오는 방법을 익히셨네요! 생각보다 어렵지 않죠? 이 과정을 차근차근 따라 하면, 개발 환경을 빠르게 설정하고 바로 코딩을 시작할 수 있어요.

 

중요한 포인트 정리:

✅ 프로젝트 가져오기 전에 실행 중인 서버를 꼭 끄세요.
✅ File > Import에서 Existing Gradle Project를 선택하세요.
✅ 프로젝트 구조를 확인하고 불필요한 파일은 정리하세요.
✅ Gradle Tasks View를 활용해 실행 및 디버깅하세요.
✅ bootRun 실행 후 브라우저에서 최종 테스트하세요.