IntelliJ IDEA에서 커피잔 아이콘은 보이는데 실행이 안 되는 문제 해결하기

IntelliJ IDEA에서 커피잔 아이콘은 보이는데 실행이 안 되는 문제 해결하기

개발을 하다 보면 IntelliJ IDEA에서 Java 파일 옆에 커피잔 아이콘이 보이는데, 실행하려고 하면 제대로 작동하지 않는 상황을 겪을 수 있습니다. 저도 같은 문제를 겪었고, 이를 해결하면서 많은 것을 배웠습니다. 이 글에서는 문제의 원인과 해결 방법을 공유하겠습니다. 같은 문제를 겪고 계신 분들께 도움이 되기를 바랍니다!

---

문제 상황

IntelliJ IDEA에서 Java 파일 옆에 커피잔 모양의 아이콘이 보이는데, 해당 파일을 실행하려고 하면 아무 동작도 하지 않거나 컴파일 에러가 발생합니다. 특히 아래와 같은 상황일 가능성이 높습니다:

1. 실행 아이콘이 뜨지 않음: "Run" 또는 "Debug" 옵션이 제대로 작동하지 않음.
2. 디렉토리 구조를 유지하고 싶음: 프로젝트의 특정 구조를 유지하면서 문제를 해결하고 싶음.

---

문제의 원인

이 문제는 주로 IntelliJ IDEA의 소스 루트 설정과 관련이 있습니다. 소스 루트가 올바르게 설정되지 않은 경우 IntelliJ는 Java 파일의 패키지를 인식하지 못하고, 실행 환경을 구성할 수 없습니다. 특히 다음과 같은 원인일 가능성이 높습니다:

1. 소스 루트가 설정되지 않음: IntelliJ IDEA는 파일이 프로젝트의 소스 코드임을 인식하려면 특정 폴더가 "소스 루트(Source Root)"로 설정되어야 합니다.
2. 패키지 구조와 실제 디렉토리 불일치: Java의 패키지 구조(package)와 실제 디렉토리 구조가 다르면 IntelliJ가 해당 클래스를 찾지 못합니다.
3. 프로젝트 SDK 누락: 프로젝트에 Java SDK가 올바르게 설정되지 않았을 수 있습니다.

---

해결 방법

1. 소스 루트를 올바르게 설정하기

소스 루트 설정은 가장 일반적인 문제 해결 방법입니다. 프로젝트 디렉토리에서 src 폴더가 소스 루트로 설정되어 있는지 확인하고, 설정되지 않았다면 다음 단계를 따르세요:

1. src 폴더를 우클릭합니다.
2. Mark Directory as > Sources Root를 선택합니다.
3. 소스 루트로 설정되면 src 폴더 아이콘이 파란색으로 바뀝니다.

Tip: Sources Root로 설정된 폴더 안에 있는 Java 파일은 IntelliJ에서 자동으로 컴파일하고 실행할 수 있습니다.

---

2. 패키지 이름과 폴더 구조 일치

Java에서는 파일의 위치가 package 선언과 일치해야 합니다. 예를 들어, 파일이 src/sec01/exam01 폴더에 있다면, Java 파일 상단의 package 선언은 다음과 같아야 합니다:

java

코드 복사

package sec01.exam01;

만약 디렉토리 구조와 패키지 이름이 일치하지 않는다면, 패키지 이름을 수정하거나 파일을 올바른 디렉토리로 이동하세요.

---

3. 프로젝트 SDK 확인

Java SDK가 올바르게 설정되지 않은 경우에도 이 문제가 발생할 수 있습니다. 다음 단계를 통해 확인하고 설정하세요:

1. 상단 메뉴에서 File > Project Structure (Ctrl+Alt+Shift+S)로 이동합니다.
2. Project Settings > Project로 이동하여 Project SDK가 올바르게 설정되어 있는지 확인합니다.
3. 설정이 되어 있지 않다면 Add SDK를 클릭하고, 설치된 Java SDK를 선택합니다.

---

4. 빌드와 실행 설정 확인

모든 설정이 올바르더라도 실행 구성이 제대로 되어 있지 않으면 문제가 발생할 수 있습니다. 실행 구성을 새로 만들어보세요:

1. 우측 상단의 Run Configuration 드롭다운에서 Edit Configurations...를 선택합니다.
2. + 버튼을 클릭하여 Application을 선택합니다.
3. Main class에 실행할 클래스의 전체 이름(예: sec01.exam01.VariableInitializationExample)을 입력합니다.
4. Use classpath of module에서 올바른 모듈을 선택합니다.

---

5. Gradle 또는 Maven 동기화

Gradle이나 Maven 프로젝트인 경우, 동기화가 필요합니다.

• Gradle: Gradle 탭에서 새로고침 아이콘 클릭
• Maven: Maven 탭에서 새로고침 아이콘 클릭

---

문제 해결 후

위 단계를 모두 수행한 뒤에는 IntelliJ IDEA에서 커피잔 아이콘을 클릭하면 정상적으로 실행되는 것을 확인할 수 있습니다.

저의 경우, 1. 소스 루트를 설정하는 것만으로 문제가 해결되었습니다.