IntelliJ - 스프링 스타터 추가 인식 안됨 해결

IntelliJ IDEA에서 Gradle 프로젝트를 진행할 때, build.gradle 파일 내에서 Add Starters... 옵션이 나타나지 않거나 인식되지 않는 현상이 발생할 수 있습니다.

1. 현상

• build.gradle 파일 내 dependencies 영역 상단에 Add Starters... 버튼이 활성화되지 않음
• 다운로드(Downloads) 폴더 등 특정 위치에 프로젝트가 있을 때는 정상 동작하지만, 다른 폴더로 이동하면 인식이 안 됨

2. 원인

프로젝트가 위치한 파일 경로(Path)에 한글이나 특수문자가 포함되어 있을 경우, IntelliJ 플러그인이 프로젝트 경로를 제대로 인덱싱하지 못해 발생하는 문제입니다.

3. 해결 방법

결론: 프로젝트의 전체 파일 경로를 전면 영문으로 구성하자.

1. IntelliJ를 종료합니다.
2. 프로젝트가 담긴 상위 폴더부터 프로젝트 폴더 이름까지 모두 영문으로 변경합니다.
   • ❌ C:\사용자\홍길동\스프링_프로젝트\demo
   • ⭕ C:\Users\username\projects\demo
3. IntelliJ에서 변경된 영문 경로로 프로젝트를 다시 열어 build.gradle을 확인합니다.