Qt 애플리케이션 디버깅
실행 중인 애플리케이션을 종료되기 전에 일시 중지하거나, 애플리케이션이 제대로 작동하지 않는 원인을 파악할 수 있습니다. 중단점을 설정하여 애플리케이션을 일시 중지한 후 변수를 확인 및 수정하고, 새로운 중단점을 설정하거나 기존 중단점을 제거한 다음, 애플리케이션 실행을 재개할 수 있습니다.
애플리케이션이 중지되면 디버거에서 특정 데이터를 확인할 수 있습니다. 사용 가능한 데이터는 애플리케이션을 컴파일할 때의 컴파일러 설정과 애플리케이션이 중지된 정확한 위치에 따라 달라집니다. 표준 VS Code 기능인 ‘단계 진입(step into)’, ‘단계 건너뛰기(step over)’, ‘단계 종료(step out)’를 사용하여 코드를 단계별로 실행하고 변수의 변화를 확인하십시오.
자세한 내용은 VS Code 문서의 “VS Code : 디버깅”을 참조하십시오.
디버깅을 위해 프로젝트 구성
애플리케이션에 Qt 디버그 구성을 추가하려면:
- Run and Debug (macOS에서는Ctrl+Shift+D 또는 Cmd+Shift+D )로 이동합니다.

- 실행 구성이 포함된 launch.json 파일(1)을 생성합니다.
- Add Configuration (2)를 선택한 다음, 사용 중인 디버거에 맞는 ‘ Qt: Debug ’ 디버그 구성을 선택합니다.
- 실행 대상(3)을 확인합니다. 변경하려면 대상 이름을 선택하거나 Command Palette 로 이동하여 ‘ CMake: Set Launch/Debug Target ’를 선택하십시오.
소스 코드 디버깅
Qt 소스 코드를 디버그할 수도 있습니다. 하지만 vcpkg를 사용하여 Qt를 설치한 경우, VS Code용 Qt 확장 프로그램이 소스 코드를 찾지 못해 경고가 표시됩니다. 이 경고를 비활성화하려면:
- Command Palette 로 이동하여 ‘ Open Qt settings ’를 선택합니다.
- Qt C++ Configuration 를 선택한 다음, Do Not Warn Missing Source Dir 를 선택합니다.
Qt 디버그 구성
다음 Qt 디버그 구성 중 하나를 선택하십시오:
- Qt: Debug with cppdbg GDB를 사용하여 C/C++ 애플리케이션을 디버깅할 경우.
- Qt: Debug with cppvsdbg (Windows) Visual Studio Windows 디버거를 사용하여 C/C++ 애플리케이션을 디버깅할 경우.
- Qt: QML: Attach by port 실행 중인 애플리케이션에 QML 디버거를 연결하여 QML 코드를 디버깅할 때 사용합니다.
- Qt: QML: Launch 먼저 애플리케이션을 시작한 다음, QML 디버거를 연결하여 QML 코드를 디버깅하는 경우.
- Qt: Debug with cppdbg and QML debugger GDB와 QML 디버거를 사용하여 C/C++ 코드가 포함된 Qt Quick 애플리케이션을 디버깅하는 경우.
- Qt: Debug with cppvsdbg and QML debugger (Windows) Visual Studio Windows 디버거와 QML 디버거를 사용하여 C/C++ 코드가 포함된 Qt Quick 애플리케이션을 디버깅하는 방법.
- Qt: PySide: Launch
debugpy을 사용하여 애플리케이션을 디버깅하는 방법. Qt for Python - Qt: PySide: Launch with QML Debugger
debugpy및 QML 디버거를 사용하여 및 QML 애플리케이션을 디버깅하는 경우. Qt for Python - Qt: Debug with lldb LLDB를 사용한 디버깅용.
- Qt: Debug Qt WASM with Chrome Chrome을 사용하여 Qt WebAssembly 애플리케이션을 디버깅하는 방법.
‘ Qt Quick 애플리케이션 디버깅’, ‘ Qt for Python 애플리케이션 디버깅’, ‘Qt WebAssembly 애플리케이션 디버깅’ 및 ‘VS Code: 디버깅’항목도 참조하십시오 .
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.