Qtアプリケーションのデバッグ
実行中のアプリケーションを、終了する前に中断したり、アプリケーションが正しく動作しない原因を特定したりすることができます。ブレークポイントを設定してアプリケーションを一時停止し、変数の確認や変更、新しいブレークポイントの設定、古いブレークポイントの削除を行った後、アプリケーションの実行を再開します。
アプリケーションが停止すると、デバッガーで特定のデータを調べることができます。利用可能なデータは、アプリケーションのコンパイル時のコンパイラ設定や、アプリケーションが停止した正確な位置によって異なります。標準の VS Code 機能(ステップイン、ステップオーバー、ステップアウト)を使用して、コードを順を追って実行し、変数の変化を確認してください。
詳細については、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 をインストールした場合、Qt Extension for VS Code はソースコードを検出できず、警告が表示されます。この警告を無効にするには:
- 「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.