デバッグ
デバッグセッション中に、デバッガーをアタッチしてプログラムを起動します。 デバッガーの目的は、プログラムの実行を妨害し、内部で何が起こっているかに関する情報を提供することです。 これにより、プログラムのバグを検出して修正するプロセスが容易になります。
デバッグが初めての場合は、 PyCharm を使用したデバッグ チュートリアルを試してください。
Debugger implementations
PyCharm supports multiple debugger implementations. In addition to the default PyCharm debugger, you can use debugpy, which is based on the Debug Adapter Protocol.
To enable debugpy, do one of the following:
に進みます。 Select the required option in the Debugger mode field.
Hover over the デバッグ tool window and use the selector in the upper-right corner.
デバッグオプションを設定する
で一般的な デバッグプロパティと動作を構成します。
デバッグが初めての場合は、すぐに使用できる構成が機能します。 各デバッガー機能に関するトピックは、参照を提供し、該当する場合は関連する設定を説明します。 上級ユーザーで特定のプロパティを探している場合は、 デバッガーリファレンスセクションを参照してください。
ビルド、実行、デプロイ セクションで、 デバッガー を選択し、Python デバッガーオプションを構成します。
セクションで、一部のデバッグ構成に必要になる可能性がある Python パッケージを構成します。
カスタム 実行/デバッグ構成を使用する場合は、定義してください。 これは、プログラムに引数を渡す必要がある場合、または起動前に特別なアクティビティを実行する必要がある場合に必要です。 実行 / デバッグ構成のセットアップの詳細については、 実行 / デバッグ構成 セクションを参照してください。 ほとんどの場合、引数を期待しない、特別な要件がない単純なプログラムをデバッグする場合、これは必要ありません。
一般的なデバッグ手順
アプリケーションをデバッグするための万能の手順はありません。 実際の要件に応じて、異なるアクションを異なる順序で使用する必要がある場合があります。 このトピックでは、一般的なデバッグ手順を表す一般的なガイドラインを提供します。 特定の機能をいつどのように使用するかについての詳細は、それぞれのトピックで説明されています。
プログラムを停止する必要がある場所を定義します。 これは ブレークポイントを使用して行います。 ブレークポイントは特別なマーカーであり、デバッガーがプログラム状態に介入してフリーズする必要があるときの場所と条件を表します。 デバッガーによってフリーズされたプログラムは、 「一時停止」と呼ばれます。
ブレークポイントを使用する代わりに、任意の時点でプログラムを 手動で一時停止することもできますが、この方法ではデバッガーの機能にいくつかの制限が課せられ、プログラムを一時停止するタイミングに関する精度が高くなりません。
エディターの任意の行を右クリックして、コンテキストメニューから <ファイル名> をデバッグする コマンドを選択するだけです。
プログラムが中断された後、デバッガーを使って プログラムの状態に関する情報および実行中の変化を取得します。
デバッガーは、変数値、スレッドの現在の状態、現在ヒープにあるオブジェクトの内訳などに関する情報を提供します。 また、例外をスローする（たとえば、処理方法を確認する）か、プログラム実行の途中で任意のコードを実行することにより、さまざまな条件でプログラムをテストできます。
これらのツールを使用すると、特定の時点でのプログラムの状態を調べることができますが、 ステップ機能を使用すると、プログラムの段階的な実行を制御できます。 ツールを組み合わせることで、バグの原因を推測し、プログラムの堅牢性をテストできます。