본문으로 건너뛰기

자바 실행 및 디버깅

Visual Studio Code는 Debugger for Java 확장을 통해 자바 애플리케이션을 디버깅할 수 있습니다. 이는 Java Debug Server를 기반으로 한 경량 자바 디버거로, Red Hat의 Java™에 대한 언어 지원을 확장합니다.

지원되는 디버깅 기능 목록은 다음과 같습니다:

  • 실행/첨부
  • 중단점
  • 예외
  • 일시 정지 및 계속
  • 단계별 진입/탈출/건너뛰기
  • 변수
  • 호출 스택
  • 스레드
  • 디버그 콘솔
  • 평가
  • 핫 코드 교체

자바 디버거는 오픈 소스 프로젝트로, GitHub 리포지토리를 통해 기여자들의 협업을 환영합니다:

아래 기능을 사용할 때 문제가 발생하면, 이슈를 입력하여 저희에게 연락할 수 있습니다.

설치​

Visual Studio Code에서 완전한 자바 언어 지원을 받으려면, Extension Pack for Java를 설치할 수 있으며, 이 패키지에는 Debugger for Java 확장이 포함되어 있습니다.

Java용 확장 팩 설치

확장 팩을 시작하는 방법에 대한 자세한 내용은 Java 시작하기 튜토리얼을 참조하세요.

구성​

기본적으로 디버거는 메인 클래스를 자동으로 찾아 애플리케이션을 실행하기 위해 메모리에 기본 실행 구성을 생성하여 실행됩니다.

실행 구성을 사용자 정의하고 유지하려면 Run and Debug 뷰에서 launch.json 파일 생성 링크를 선택할 수 있습니다.

디버그 메뉴

launch.json 파일은 작업 공간의 .vscode 폴더에 위치합니다 (프로젝트 루트 폴더).

launch.json 파일을 생성하는 방법에 대한 자세한 내용은 실행 구성을 읽고, 자바에 대한 구성 옵션에 대한 자세한 내용은 구성 옵션을 참조하세요.

실행 및 디버그​

디버거 확장은 자바 애플리케이션을 실행하고 디버깅하는 여러 가지 방법을 제공합니다.

CodeLens에서 실행​

main() 함수의 CodeLens에서 Run|Debug를 찾을 수 있습니다.

CodeLens

편집기 메뉴에서 실행​

디버깅을 시작하는 또 다른 방법은 상단 편집기 제목 표시줄에서 Run Java 또는 Debug Java 메뉴를 선택하는 것입니다.

편집기 메뉴

F5 키를 눌러 실행​

kb(workbench.action.debug.start)를 눌러 디버거가 프로젝트의 진입점을 자동으로 찾아 디버깅을 시작합니다. 또한 VS Code의 사이드 바에서 Run and Debug 뷰를 통해 디버깅 세션을 시작할 수 있습니다. 자세한 내용은 VS Code에서 디버깅을 참조하세요.

단일 파일 디버깅​

VS Code는 빌드 도구로 관리되는 자바 프로젝트의 디버깅을 지원하는 것 외에도, 프로젝트 없이 단일 자바 파일을 디버깅할 수 있습니다.

디버그 세션 입력​

VS Code의 기본 디버그 콘솔은 입력을 지원하지 않습니다. 프로그램이 터미널에서 입력을 필요로 하는 경우, VS Code 내의 통합 터미널(kb(workbench.action.terminal.toggleTerminal)) 또는 외부 터미널을 사용하여 실행할 수 있습니다. 또한 사용자 설정 java.debug.settings.console을 사용하여 모든 자바 디버그 세션에 대한 전역 콘솔을 구성할 수 있습니다.

중단점​

Debugger for Java는 라인 중단점, 조건부 중단점, 데이터 중단점 및 로그 포인트와 같은 다양한 중단점을 지원합니다.

중단점 - 조건부 중단점​

표현식 평가의 도움으로 디버거는 조건부 중단점도 지원합니다. 표현식이 true로 평가될 때 중단하도록 중단점을 설정할 수 있습니다.

중단점 - 데이터 중단점​

변수의 값이 변경될 때 디버거가 중단되도록 설정할 수 있습니다. 데이터 중단점은 디버그 세션 내에서만 설정할 수 있습니다. 즉, 애플리케이션을 실행하고 일반 중단점에서 중단해야 합니다. 그런 다음 VARIABLES 뷰에서 필드를 선택하고 데이터 중단점을 설정할 수 있습니다.

데이터 중단점

중단점 - 로그 포인트​

로그 포인트도 자바 디버거에서 지원됩니다. 로그 포인트를 사용하면 코드를 수정하지 않고도 디버그 콘솔에 출력을 보낼 수 있습니다. 로그 포인트는 애플리케이션의 실행 흐름을 중단하지 않기 때문에 중단점과 다릅니다.

중단점 - 트리거된 중단점​

트리거된 중단점은 다른 중단점이 발생할 때 자동으로 활성화되는 중단점입니다. 특정 전제 조건이 충족된 후에만 발생하는 코드의 실패 사례를 진단할 때 매우 유용할 수 있습니다.

트리거된 중단점은 기호 여백에서 마우스 오른쪽 버튼을 클릭하고 트리거된 중단점 추가를 선택한 다음 어떤 다른 중단점이 이 중단점을 활성화하는지 선택하여 설정할 수 있습니다.

표현식 평가​

디버거는 WATCH 창과 디버그 콘솔에서 표현식을 평가할 수 있도록 해줍니다.

핫 코드 교체​

디버거가 지원하는 또 다른 고급 기능은 '핫 코드' 교체입니다. 핫 코드 교체(HCR)는 자바 디버거가 디버깅 채널을 통해 클래스 변경 사항을 다른 자바 가상 머신(JVM)으로 전송하는 디버깅 기술입니다. HCR은 실험적 개발을 촉진하고 반복적인 시행착오 코딩을 촉진합니다. 이 새로운 기능을 사용하면 디버깅 세션을 시작하고 개발 환경에서 자바 파일을 변경할 수 있으며, 디버거는 실행 중인 JVM에서 코드를 교체합니다. 재시작이 필요하지 않기 때문에 "핫"이라고 불립니다. 아래는 VS Code에서 Debugger for Java와 함께 HCR을 사용하는 방법을 보여주는 그림입니다.

디버그 설정 java.debug.settings.hotCodeReplace를 사용하여 핫 코드 교체를 트리거하는 방법을 제어할 수 있습니다. 가능한 설정 값은 다음과 같습니다:

  • manual - 변경 사항을 적용하려면 툴바를 클릭합니다 (기본값).
  • auto - 컴파일 후 자동으로 변경 사항을 적용합니다.
  • never - 핫 코드 교체를 비활성화합니다.

단계 필터링​

단계 필터링은 디버깅 중에 보고 싶지 않은 유형을 필터링하기 위해 확장에서 지원됩니다. 이 기능을 사용하면 launch.json 내에서 필터링할 패키지를 구성하여 단계별로 건너뛸 수 있습니다.

구성 옵션​

디버거를 구성하기 위한 많은 옵션과 설정이 있습니다. 예를 들어, JVM 인수 및 환경 변수를 구성하는 것은 실행 옵션으로 쉽게 수행할 수 있습니다.

프로젝트 설정을 도와주기 위해 Red Hat의 Java™에 대한 언어 지원 확장 문서를 참조하세요.

많이 사용되는 설정에 대한 샘플은 VS Code Java Debugger Configuration에서 확인할 수 있습니다. 이 문서에서는 자바 디버거가 자동으로 구성을 생성하는 방법과 이를 수정해야 할 경우 메인 클래스, 다양한 인수, 환경, 다른 자바 프로세스에 첨부하는 방법 및 더 고급 기능의 사용 방법을 설명합니다.

아래는 Launch 및 Attach에 대해 사용할 수 있는 모든 구성입니다. launch.json 파일을 작성하는 방법에 대한 자세한 내용은 디버깅을 참조하세요.

실행​

  • mainClass (필수) - 완전한 클래스 이름(예: [java 모듈 이름/]com.xyz.MainApp) 또는 프로그램 진입점의 자바 파일 경로입니다.
  • args - 프로그램에 전달되는 명령줄 인수입니다. 프로그램 인수를 입력하라는 프롬프트를 표시하려면 "$\{command:SpecifyProgramArgs\}"를 사용합니다. 문자열 또는 문자열 배열을 허용합니다.
  • sourcePaths - 프로그램의 추가 소스 디렉토리입니다. 디버거는 기본적으로 프로젝트 설정에서 소스 코드를 찾습니다. 이 옵션을 사용하면 디버거가 추가 디렉토리에서 소스 코드를 찾을 수 있습니다.
  • modulePaths - JVM을 실행하기 위한 모듈 경로입니다. 지정하지 않으면 디버거가 현재 프로젝트에서 자동으로 해결합니다.
    • $Auto - 현재 프로젝트의 모듈 경로를 자동으로 해결합니다.
    • $Runtime - 현재 프로젝트의 'runtime' 범위 내 모듈 경로입니다.
    • $Test - 현재 프로젝트의 'test' 범위 내 모듈 경로입니다.
    • !/path/to/exclude - 지정된 경로를 모듈 경로에서 제외합니다.
    • /path/to/append - 지정된 경로를 모듈 경로에 추가합니다.
  • classPaths - JVM을 실행하기 위한 클래스 경로입니다. 지정하지 않으면 디버거가 현재 프로젝트에서 자동으로 해결합니다.
    • $Auto - 현재 프로젝트의 클래스 경로를 자동으로 해결합니다.
    • $Runtime - 현재 프로젝트의 'runtime' 범위 내 클래스 경로입니다.
    • $Test - 현재 프로젝트의 'test' 범위 내 클래스 경로입니다.
    • !/path/to/exclude - 지정된 경로를 클래스 경로에서 제외합니다.
    • /path/to/append - 지정된 경로를 클래스 경로에 추가합니다.
  • encoding - JVM의 file.encoding 설정입니다. 지정하지 않으면 'UTF-8'이 사용됩니다. 가능한 값은 지원되는 인코딩에서 확인할 수 있습니다.
  • vmArgs - JVM에 대한 추가 옵션 및 시스템 속성(예: -Xms<size> -Xmx<size> -D<name>=<value>)입니다. 문자열 또는 문자열 배열을 허용합니다.
  • projectName - 디버거가 클래스를 검색하는 기본 프로젝트입니다. 서로 다른 프로젝트에 중복된 클래스 이름이 있을 수 있습니다. 이 설정은 디버거가 프로그램을 실행할 때 지정된 메인 클래스를 찾을 때도 작동합니다. 작업 공간에 여러 자바 프로젝트가 있는 경우 필수이며, 그렇지 않으면 표현식 평가 및 조건부 중단점이 작동하지 않을 수 있습니다.
  • cwd - 프로그램의 작업 디렉토리입니다. 기본값은 $\{workspaceFolder\}입니다.
  • env - 프로그램에 대한 추가 환경 변수입니다.
  • envFile - 환경 변수 정의가 포함된 파일의 절대 경로입니다.
  • stopOnEntry - 프로그램을 실행한 후 자동으로 일시 정지합니다.
  • console - 프로그램을 실행할 콘솔입니다. 지정하지 않으면 java.debug.settings.console 사용자 설정에 의해 지정된 콘솔을 사용합니다.
    • internalConsole - VS Code 디버그 콘솔 (입력 스트림 지원 안 함).
    • integratedTerminal - VS Code 통합 터미널.
    • externalTerminal - 사용자 설정에서 구성할 수 있는 외부 터미널입니다.
  • shortenCommandLine - 프로젝트에 긴 클래스 경로 또는 큰 VM 인수가 있을 경우, 프로그램을 실행하기 위한 명령줄이 OS에서 허용하는 최대 명령줄 문자열 제한을 초과할 수 있습니다. 이 구성 항목은 명령줄을 단축하기 위한 여러 접근 방식을 제공합니다. 기본값은 auto입니다.
    • none - 표준 명령줄 'java {options} classname {args}'로 프로그램을 실행합니다.
    • jarmanifest - 클래스 경로 매개변수를 임시 classpath.jar 파일로 생성하고, 명령줄 'java -cp classpath.jar classname{args}'로 프로그램을 실행합니다.
    • argfile - 클래스 경로 매개변수를 임시 인수 파일로 생성하고, 명령줄 'java @argfile {args}'로 프로그램을 실행합니다. 이 값은 Java 9 이상에만 적용됩니다.
    • auto - 명령줄 길이를 자동으로 감지하고 적절한 방법으로 명령줄을 단축할지 결정합니다.
  • stepFilters - 단계를 수행할 때 지정된 클래스 또는 메서드를 건너뜁니다.
    • classNameFilters - [사용 중단 - skipClasses로 대체됨] 단계를 수행할 때 지정된 클래스를 건너뜁니다. 클래스 이름은 완전한 자격을 가져야 합니다. 와일드카드가 지원됩니다.
    • skipClasses - 단계를 수행할 때 지정된 클래스를 건너뜁니다. '$JDK' 및 '$Libraries'와 같은 내장 변수를 사용하여 클래스 그룹을 건너뛰거나, 특정 클래스 이름 표현식을 추가할 수 있습니다. 예: java.*, *.Foo.
    • skipSynthetics - 단계를 수행할 때 합성 메서드를 건너뜁니다.
    • skipStaticInitializers - 단계를 수행할 때 정적 초기화 메서드를 건너뜁니다.
    • skipConstructors - 단계를 수행할 때 생성자 메서드를 건너뜁니다.

첨부​

  • hostName (필수) - 원격 디버깅 대상의 호스트 이름 또는 IP 주소입니다.
  • port (필수) - 원격 디버깅 대상의 디버그 포트입니다.
  • processId - 첨부할 프로세스를 선택하기 위해 프로세스 선택기를 사용하거나 정수로 프로세스 ID를 입력합니다.
    • $\{command:PickJavaProcess\} - 프로세스 선택기를 사용하여 첨부할 프로세스를 선택합니다.
    • 정수 PID - 지정된 로컬 프로세스에 첨부합니다.
  • timeout - 재연결하기 전의 타임아웃 값(밀리초 단위, 기본값 30000 ms).
  • sourcePaths - 프로그램의 추가 소스 디렉토리입니다. 디버거는 기본적으로 프로젝트 설정에서 소스 코드를 찾습니다. 이 옵션을 사용하면 디버거가 추가 디렉토리에서 소스 코드를 찾을 수 있습니다.
  • projectName - 디버거가 클래스를 검색하는 기본 프로젝트입니다. 서로 다른 프로젝트에 중복된 클래스 이름이 있을 수 있습니다. 작업 공간에 여러 자바 프로젝트가 있는 경우 필수이며, 그렇지 않으면 표현식 평가 및 조건부 중단점이 작동하지 않을 수 있습니다.
  • stepFilters - 단계를 수행할 때 지정된 클래스 또는 메서드를 건너뜁니다.
    • classNameFilters - [사용 중단 - skipClasses로 대체됨] 단계를 수행할 때 지정된 클래스를 건너뜁니다. 클래스 이름은 완전한 자격을 가져야 합니다. 와일드카드가 지원됩니다.
    • skipClasses - 단계를 수행할 때 지정된 클래스를 건너뜁니다. '$JDK' 및 '$Libraries'와 같은 내장 변수를 사용하여 클래스 그룹을 건너뛰거나, 특정 클래스 이름 표현식을 추가할 수 있습니다. 예: java.*, *.Foo.
    • skipSynthetics - 단계를 수행할 때 합성 메서드를 건너뜁니다.
    • skipStaticInitializers - 단계를 수행할 때 정적 초기화 메서드를 건너뜁니다.
    • skipConstructors - 단계를 수행할 때 생성자 메서드를 건너뜁니다.

사용자 설정​

  • java.debug.logLevel: VS Code에 전송되는 디버거 로그의 최소 수준으로, 기본값은 warn입니다.
  • java.debug.settings.showHex: 변수에서 숫자를 16진수 형식으로 표시합니다. 기본값은 false입니다.
  • java.debug.settings.showStaticVariables: 변수에서 정적 변수를 표시합니다. 기본값은 false입니다.
  • java.debug.settings.showQualifiedNames: 변수에서 완전한 클래스 이름을 표시합니다. 기본값은 false입니다.
  • java.debug.settings.showLogicalStructure: 변수에서 컬렉션 및 맵 클래스의 논리적 구조를 표시합니다. 기본값은 true입니다.
  • java.debug.settings.showToString: 변수에서 'toString()' 메서드를 재정의한 모든 클래스의 'toString' 값을 표시합니다. 기본값은 true입니다.
  • java.debug.settings.maxStringLength: 변수 또는 디버그 콘솔에 표시되는 문자열의 최대 길이입니다. 이 제한을 초과하는 문자열은 잘립니다. 기본값은 0으로, 잘림이 수행되지 않습니다.
  • java.debug.settings.hotCodeReplace: 디버깅 중 변경된 자바 클래스를 다시 로드합니다. 기본값은 manual입니다. Java Language Support 확장의 java.autobuild.enabled가 비활성화되지 않았는지 확인하세요. 사용법 및 제한 사항에 대한 자세한 내용은 핫 코드 교체 위키 페이지를 참조하세요.
    • manual - 변경 사항을 적용하려면 툴바를 클릭합니다.
    • auto - 컴파일 후 자동으로 변경 사항을 적용합니다.
    • never - 변경 사항을 적용하지 않습니다.
  • java.debug.settings.enableHotCodeReplace: 자바 코드에 대한 핫 코드 교체를 활성화합니다. VS Code Java의 자동 빌드가 비활성화되지 않았는지 확인하세요. 사용법 및 제한 사항에 대한 자세한 내용은 핫 코드 교체 위키 페이지를 참조하세요.
  • java.debug.settings.enableRunDebugCodeLens: 메인 진입점 위에 실행 및 디버그 버튼에 대한 CodeLens 공급자를 활성화합니다. 기본값은 true입니다.
  • java.debug.settings.forceBuildBeforeLaunch: 자바 프로그램을 실행하기 전에 작업 공간을 강제로 빌드합니다. 기본값은 true입니다.
  • java.debug.settings.console: 자바 프로그램을 실행할 콘솔입니다. 기본값은 integratedTerminal입니다. 특정 디버그 세션에 대한 콘솔을 사용자 정의하려면 launch.json의 console 구성을 수정하세요.
    • internalConsole - VS Code 디버그 콘솔 (입력 스트림 지원 안 함).
    • integratedTerminal - VS Code 통합 터미널.
    • externalTerminal - 사용자 설정에서 구성할 수 있는 외부 터미널입니다.
  • java.debug.settings.exceptionBreakpoint.skipClasses: 예외에서 중단할 때 지정된 클래스를 건너뜁니다. '$JDK' 및 '$Libraries'와 같은 내장 변수를 사용하여 클래스 그룹을 건너뛰거나, 특정 클래스 이름 표현식을 추가할 수 있습니다. 예: java.*, *.Foo.
  • java.debug.settings.stepping.skipClasses: 단계를 수행할 때 지정된 클래스를 건너뜁니다. '$JDK' 및 '$Libraries'와 같은 내장 변수를 사용하여 클래스 그룹을 건너뛰거나, 특정 클래스 이름 표현식을 추가할 수 있습니다. 예: java.*, *.Foo.
  • java.debug.settings.stepping.skipSynthetics: 단계를 수행할 때 합성 메서드를 건너뜁니다.
  • java.debug.settings.stepping.skipStaticInitializers: 단계를 수행할 때 정적 초기화 메서드를 건너뜁니다.
  • java.debug.settings.stepping.skipConstructors: 단계를 수행할 때 생성자 메서드를 건너뜁니다.
  • java.debug.settings.jdwp.limitOfVariablesPerJdwpRequest: 한 JDWP 요청에서 요청할 수 있는 변수 또는 필드의 최대 수입니다. 값이 높을수록 변수 뷰를 확장할 때 디버깅 대상이 요청되는 빈도가 줄어듭니다. 또한 많은 수는 JDWP 요청 시간 초과를 초래할 수 있습니다. 기본값은 100입니다.
  • java.debug.settings.jdwp.requestTimeout: 디버거가 대상 JVM과 통신할 때 JDWP 요청의 타임아웃(밀리초 단위)입니다. 기본값은 3000입니다.
  • java.debug.settings.vmArgs: 자바 프로그램을 실행하기 위한 기본 VM 인수입니다. 예를 들어, '-Xmx1G -ea'를 사용하여 힙 크기를 1GB로 늘리고 어설션을 활성화합니다. 특정 디버그 세션에 대한 VM 인수를 사용자 정의하려면 launch.json의 'vmArgs' 구성을 수정할 수 있습니다.
  • java.silentNotification: 진행 상황을 보고하기 위해 알림을 사용할 수 있는지 제어합니다. true인 경우 상태 표시줄을 사용하여 진행 상황을 보고합니다. 기본값은 false입니다.

문제 해결​

디버거를 사용할 때 문제가 발생하면 vscode-java-debug GitHub 리포지토리에서 자세한 문제 해결 가이드를 찾을 수 있습니다.

설명된 일반적인 문제는 다음과 같습니다:

  • Java Language Support 확장이 시작되지 않습니다.
  • 빌드 실패, 계속하시겠습니까?
  • *.java가 클래스 경로에 없습니다. 구문 오류만 보고됩니다.
  • 프로그램 오류: 메인 클래스 X를 찾거나 로드할 수 없습니다.
  • 프로그램이 ClassNotFoundException을 발생시킵니다.
  • 핫 코드 교체를 완료하지 못했습니다.
  • launch.json에서 원격 디버깅 대상의 호스트 이름과 포트를 지정하세요.
  • 평가 실패. 이유: 스레드가 재개되어 평가할 수 없습니다.
  • 메인 메서드가 있는 클래스를 찾을 수 없습니다.
  • 디버거 시작 시 vscode.java.startDebugSession에 대한 delegateCommandHandler가 없습니다.
  • 클래스 경로를 해결하지 못했습니다.
  • 요청 유형 "X"는 지원되지 않습니다. "launch" 및 "attach"만 지원됩니다.

피드백 및 질문​

전체 문제 목록은 vscode-java-debug 리포지토리에서 확인할 수 있습니다. 버그 또는 기능 제안을 제출하고 커뮤니티 주도의 vscode-java-debug Gitter 채널에 참여할 수 있습니다.

다음 단계​

다음 내용을 읽어보세요:

  • 디버깅 - VS Code에서 프로젝트와 함께 디버거를 사용하는 방법을 알아보세요.

자바에 대한 내용은:

  • 자바 테스트 - Java Test Runner 확장을 사용하여 VS Code 내에서 자바를 테스트하세요.
  • 자바 확장 - VS Code에 유용한 자바 확장에 대해 알아보세요.