vscode 기반 IDE에서 Java 메서드 이동 안되는 이유와 해결 방법

작성일: 2026. 3. 25.

VS Code·Cursor 등 VS Code 계열에서 Java의 “정의로 이동(Go to Definition)”, “구현으로 이동”이 동작하지 않으면 대부분 Language Support for Java 확장과 JDK·프로젝트 로딩 문제입니다.

1. 필수 확장 확인

Extension Pack for Java(또는 동일 기능 묶음)가 설치·활성화되어 있는지 확인합니다.
워크스페이스에서 Java 관련 확장이 비활성화(Workspace Trust 등)되지 않았는지 봅니다.

2. JDK 설정

java.configuration.runtimes에 프로젝트가 요구하는 JDK 버전을 등록합니다.
java.jdt.ls.java.home은 언어 서버가 사용할 JDK입니다. JDK 17 이상을 쓰는 구성이 흔합니다(도구 체인 정책에 맞출 것).
터미널의 java -version과 VS Code가 쓰는 JDK가 다르면 혼란이 생길 수 있으니 설정 화면에서 실제 경로를 맞춥니다.

3. 프로젝트 가져오기

Maven/Gradle 프로젝트는 루트에 pom.xml 또는 build.gradle이 열린 폴더로 워크스페이스를 잡습니다.
멀티 모듈이면 상위 루트를 연 뒤 Java: Clean Java Language Server Workspace 후 다시 임포트합니다.
소스 폴더가 클래스패스에 안 올라가면 심볼 해석이 안 되어 이동이 실패합니다.

4. 인덱싱·캐시

처음 열 때 하단에 빌드/인덱싱이 오래 걸리면 이동이 잠시 안 될 수 있습니다. 문제가 지속되면 명령 팔레트에서 Java: Clean Java Language Server Workspace를 실행하고 창을 다시 로드합니다.

5. 그래도 안 될 때

해당 파일이 실제 컴파일 단위에 포함되는지(테스트 소스 경로, generated 소스 제외 등)
문법 오류로 파서가 파일 전체를 포기한 경우: 빨간 밑줄 근처를 먼저 수정
바이너리만 있고 소스가 없는 의존성: 디컴파일·소스 첨부 여부

원문: vscode 기반 IDE에서 Java 메서드 이동 안되는 이유와 해결 방법