PyCharm 2024.3 ヘルプ

デバッグツールウィンドウ

デバッガーセッションを開始すると、デバッグツールウィンドウが開きます。このウィンドウを使用して、デバッガーセッションを制御しプログラムデータ (フレーム、変数など) を表示および分析し、デバッガーアクションを実行します。

デフォルトでは、プログラムがブレークポイントに到達したときにデバッグツールウィンドウが開き、セッションが終了しても非表示になりません。この動作を変更するには、ビルド、実行、デプロイ | デバッガー設定ページ Ctrl+Alt+S に移動し、ブレークポイントでデバッグウィンドウを表示するチェックボックスをオフにします。

Debug tool window overview
  1. セッションタブ

  2. デバッガーコンソールタブ

  3. 変数監視

  4. フレーム

  5. デバッガーツールバー

セッション

使用可能なデバッグセッションは、デバッグツールウィンドウの上部でタブに分割されています。

特定の実行 / デバッグ構成に対してサービスツールウィンドウを有効にすると、これらの構成のいずれかをデバッグするときに、デバッグツールウィンドウのビュー全体がサービスツールウィンドウ内に表示されます。

インライン変数値や実行ポイントなど、エディター内のすべての情報は、選択したセッションタブに表示されます。これは、同じを使用する複数のデバッグセッションを並行して実行している場合に重要です。

タブを閉じると、対応するデバッグセッションが終了します。

デバッグツールバー

選択したタブに関係なく、ウィンドウの左側にある次のツールバーコントロールをいつでも使用できます。

項目

ツールチップとショートカット

説明

Restart

再実行

Ctrl+F5

現在のアプリケーションを停止してもう一度実行するには、このボタンをクリックします。

Resume

再開

F9

アプリケーションが一時停止している場合は、このボタンをクリックしてプログラムの実行を再開します。

Pause

一時停止

Ctrl+Pause

プログラムの実行を一時停止するには、このボタンをクリックします。

Stop

停止

Ctrl+F2

標準の shutdown スクリプトを使用して、現在のプロセスを外部で終了するには、このボタンをクリックします。

ボタンを 1 回クリックするとソフトキルが呼び出され、アプリケーションが SIGINT イベントをキャッチして正常に終了します(Windows では、Ctrl+C イベントがエミュレートされます)。ボタンが 1 回クリックされると、the Kill Process button に置き換えられます。これは、次のクリックによってアプリケーションが強制終了されることを示します。たとえば、Unix では SIGKILL が送信されます。

View breakpoints

ブレークポイントの表示

Ctrl+Shift+F8

このボタンをクリックすると、ブレークポイントの動作を設定できるブレークポイントダイアログが開きます。

Mute breakpoints

ブレークポイントのミュート

ブレークポイントの状態を切り替えるには、このボタンを使用します。

デバッグツールウィンドウのツールバーで ボタンを押すと、プロジェクト内のすべてのブレークポイントがミュートされ、それらのアイコンが灰色になります (muted_breakpoint.png)。

プロジェクト内のすべてのブレークポイントを一時的にミュートして、ブレークポイントで停止せずにプログラムを実行できます。

More

詳細

次の追加アクションを含むメニューを開きます。

Show options menu

デバッガー設定

次のオプションを含むメニューを開きます。

  • プレビュータブでファイルを開く : 対応するフレームが選択されているときにプレビュータブでファイルを開くには、このオプションを選択します。

  • エディターで変数値を表示 : このオプションを選択すると、インラインデバッグ機能が有効になり、エディターでの使用の直後に変数の値を表示できます。

  • 変数をアルファベット順に並べ替え : アルファベット順に変数ペインの値をソートするには、このオプションを選択します。

  • セッション完了時にブレークポイントのミュートを解除 : デバッグセッションが終了した後、すべての無効なブレークポイントを再度有効にするには、このオプションを選択します。

  • 戻り値を表示する : このオプションを選択すると、実行中の関数の戻り値がステップ実行中に現在のフレームに表示されます。

  • 簡略化された変数ビュー : 特殊変数グループに次の名前を含めるには、このオプションを選択します。

    • すべての変数はダンダーの名前を持つ。

    • functionclassobjmodule のすべてのインスタンス。

    • IPython を持つデバッグコンソールが起動されていれば、すべての IPython 内部変数。

  • 変数ロードポリシー。以下のいずれかのポリシーを選択できます。

    • 同期 : このオプションが有効な場合、表示されるメッセージは Collecting data で、その後デバッガーは変数の値を表示します。

    • 非同期 : このオプションが有効な場合、デバッガー内の変数は個別に (非同期的に) ロードされます。この場合、変数のロードに時間がかかると、デバッガーは ...Loading Value メッセージを表示し、その後、変数の値が表示されるか、変数が遅すぎる場合は Loading timed out メッセージが表示されます。オンデマンドモードに切り替えることを提案する警告メッセージに注意してください。

    • オンデマンド : このオプションが有効な場合、デバッガーは Show Value メッセージを表示します。クリックして読み込みを有効にします。

    ロードポリシーの変更は、デバッグプロセスを再実行した後に有効になることに注意してください。

項目

ツールチップとショートカット

説明

Restart

再実行

Ctrl+F5

現在のアプリケーションを停止してもう一度実行するには、このボタンをクリックします。

Resume

再開

F9

アプリケーションが一時停止している場合は、このボタンをクリックしてプログラムの実行を再開します。

Pause

一時停止

Ctrl+Pause

プログラムの実行を一時停止するには、このボタンをクリックします。

Stop

停止

Ctrl+F2

このボタンをクリックして、標準の shutdown スクリプトを使用して現在のプロセスを外部で終了します。

View breakpoints

ブレークポイントの表示

Ctrl+Shift+F8

このボタンをクリックすると、ブレークポイントの動作を設定できるブレークポイントダイアログが開きます。

Mute breakpoints

ブレークポイントのミュート

ブレークポイントの状態を切り替えるには、このボタンを使用します。

デバッグツールウィンドウのツールバーで ボタンを押すと、プロジェクト内のすべてのブレークポイントがミュートされ、それらのアイコンが灰色になります (muted_breakpoint.png)。

ブレークポイントで停止せずにプログラムを実行するには、プロジェクト内のすべてのブレークポイントを一時的にミュートすることができます。

Show options menu

設定

このボタンをクリックして、次のオプションのメニューを開きます。

  • 値をインラインで表示する : このオプションを選択すると、インラインデバッグ機能が有効になり、エディターでの使用の直後に変数の値を表示できます。

  • アルファベット順に値をソートする : アルファベット順に変数ペインの値をソートするには、このオプションを選択します。

  • セッション完了時にブレークポイントのミュートを解除 : デバッグセッションが終了した後、すべての無効なブレークポイントを再度有効にするには、このオプションを選択します。

  • 戻り値を表示する : このオプションを選択すると、実行中の関数の戻り値がステップ実行中に現在のフレームに表示されます。

  • 簡略化された変数ビュー : 特殊変数グループに次の名前を含めるには、このオプションを選択します。

    • すべての変数はダンダーの名前を持つ。

    • functionclassobjmodule のすべてのインスタンス。

    • IPython を持つデバッグコンソールが起動されていれば、すべての IPython 内部変数。

  • 変数ロードポリシー。以下のいずれかのポリシーを選択できます。

    • 同期 : このオプションが有効な場合、表示されるメッセージは Collecting data で、その後デバッガーは変数の値を表示します。

    • 非同期 : このオプションが有効な場合、デバッガー内の変数は個別に (非同期的に) ロードされます。この場合、変数のロードに時間がかかると、デバッガーは ...Loading Value メッセージを表示し、その後、変数の値が表示されるか、変数が遅すぎる場合は Loading timed out メッセージが表示されます。オンデマンドモードに切り替えることを提案する警告メッセージに注意してください。

    • オンデマンド : このオプションが有効な場合、デバッガーは Show Value メッセージを表示します。クリックして読み込みを有効にします。

    ロードポリシーの変更は、デバッグプロセスを再実行した後に有効になることに注意してください。

タブをピン留め

現在のタブを固定または固定解除するには、このボタンをクリックします。このウィンドウで最大数のタブに達したときにタブが自動的に閉じないようにするには、タブを固定する必要があります。

ステップツールバー

項目

ツールチップとショートカット

説明

Show Execution Point

実行ポイントの表示

Alt+F10

このボタンをクリックすると、エディターで現在の実行ポイントがハイライトされ、対応するスタックフレームがフレームペインに表示されます。

Step over

ステップオーバー

F8

このボタンをクリックすると、現在のメソッドまたはファイルの次の行までプログラムが実行され、現在の実行ポイント(存在する場合)で参照されているメソッドはスキップされます。現在の行がメソッド内の最後の行である場合、このメソッドの直後に実行された行へのステップが実行されます。

Force step over

強制ステップオーバー

Alt+Shift+F8

このメソッドがブレークポイントを内部に持っていても、このボタンをクリックするとデバッガーがメソッドにステップインします。

Step into

ステップイン

F7

デバッガーを現在の実行ポイントで呼び出されたメソッドにステップインさせるには、このボタンをクリックします。

Smart step into

スマートステップイン

Shift+F7

現在の行にネストされたコールが複数含まれている場合、PyCharm ではステップインするコールを選択できます。次のコード行を考えてみましょう。

print(foo(bar("Hello")+baz("world")))

この行にはいくつかの呼び出しが含まれています。ステップインを使用すると、デバッガーはまず bar() の実装に入り、次に baz() の実装に入ります。

foo() など、どの呼び出しにステップインするかを選択する場合は、スマートステップイン Smart Step Into Shift+F7 を使用できます。

PyCharm: Smart step into - stepping into selected call

ステップインする関数を選択すると、デバッガーは選択した関数の最初のステートメントに実行ポインターを設定します。

複数のメソッド呼び出しを含む行でステップイン F7 を呼び出すときに、「スマートステップイン」動作を有効にすることができます。これを行うには、ビルド、実行、デプロイ | デバッガー | ステップ設定ページ Ctrl+Alt+S常にスマートステップインするを選択します。

Step into my code

自分のコードにステップイン

Alt+Shift+F7

このボタンをクリックすると、ライブラリソースへのステップをスキップし、自分のコードに集中できます。

Step out

ステップアウト

Shift+F8

このボタンをクリックすると、デバッガーが現在のメソッドから抜け出し、直後に実行される行に移動します。

Run to cursor

カーソル位置まで実行

Alt+F9

このボタンをクリックしてプログラムの実行を再開し、実行ポイントがエディターの現在のキャレット位置の行に到達するまで一時停止します。ブレークポイントは必要ありません。実際には、キャレットの現在行に一時的なブレークポイントが設定されていますが、プログラムの実行が一時停止されると削除されます。キャレットがすでに実行されている行に配置されている場合、以前のブレークポイントにロールバックする方法がないため、プログラムはさらに実行するために再開されるだけです。このアクションは、メソッドシーケンスの奥深くまでステップアップし、複数のメソッドを一度にステップアウトする必要がある場合に特に便利です。

指定された行に移動する前に実行する必要がある行にブレークポイントが設定されている場合、デバッガーは最初に検出されたブレークポイントで一時停止します。

Force run to cursor

ノンストップカーソルまで実行

Ctrl+Alt+F9

現在の実行ポイントとターゲットステートメントの間にブレークポイントがある場合、ノンストップカーソルまで実行 Run to Cursor Non-Stop コマンド Ctrl+Alt+F9 を使用して、デバッガーにこれらのブレークポイントをスキップさせることができます。

Evaluate expression

式の評価

Alt+F8

このボタンをクリックして、式を評価します

項目

ツールチップとショートカット

説明

Show Execution Point

実行ポイントの表示

Alt+F10

このボタンをクリックすると、エディターで現在の実行ポイントがハイライトされ、対応するスタックフレームがフレームペインに表示されます。

Step over

ステップオーバー

F8

このボタンをクリックすると、現在のメソッドまたはファイルの次の行までプログラムが実行され、現在の実行ポイント(存在する場合)で参照されているメソッドはスキップされます。現在の行がメソッド内の最後の行である場合、このメソッドの直後に実行された行へのステップが実行されます。

Step into

ステップイン

F7

デバッガーを現在の実行ポイントで呼び出されたメソッドにステップインさせるには、このボタンをクリックします。

Force step into

強制ステップイン

Alt+Shift+F7

このメソッドをスキップする場合でも、現在の実行ポイントで呼び出されたメソッドにデバッガーをステップインさせるには、このボタンをクリックします。

Step into my code

自分のコードにステップイン

Alt+Shift+F7

このボタンをクリックすると、ライブラリソースへのステップをスキップし、自分のコードに集中できます。

Step out

ステップアウト

Shift+F8

このボタンをクリックすると、デバッガーが現在のメソッドから抜け出し、直後に実行される行に移動します。

Run to cursor

カーソル位置まで実行

Alt+F9

このボタンをクリックすると、プログラム実行を再開し、実行ポイントがエディターの現在のカーソル位置の行に達するまで一時停止します。ブレークポイントは必要ありません。実際には、プログラムの実行が一時停止されると削除されるキャレットの現在の行に一時的なブレークポイントが設定されています。すでに実行されている行にキャレットが配置されている場合は、前のブレークポイントにロールバックする方法がないため、プログラムはその後の実行のために再開されます。このアクションは、メソッドのシーケンスを詳しく調べて、一度にいくつかのメソッドを終了する必要がある場合に特に便利です。

指定された行に移動する前に実行する必要がある行にブレークポイントが設定されている場合、デバッガーは最初に検出されたブレークポイントで一時停止します。

Evaluate expression

式の評価

Alt+F8

このボタンをクリックして、式を評価します

関連ページ:

デバッガーセッションを開始する

デバッガーセッションの開始は、プログラムを通常モードで実行するのと非常によく似ています。デバッガーはバックグラウンドで接続されているため、デバッガーセッションを開始するために特別な設定を行う必要はありません。PyCharm からプログラムを実行できる場合は、同じ構成を使用してプログラムをデバッグすることもできます。プログラムをデバッグするたびに、デバッガーセッションは実行 / デバッグ構成に基づきます。これにより、アプリケーションを起動するためのパラメーターとアクションを構成できます。たとえば、...

中断されたプログラムを調べる

デバッガーセッションが開始されると、デバッグツールウィンドウが表示され、次のいずれかが発生するまでプログラムが正常に実行されます。ブレークポイントがヒットしました、プログラムを手動で一時停止する、その後、プログラムは中断され、現在の状態を調べたり、実行を制御したり、実行時にさまざまなシナリオをテストしたりできます。フレームを調べる:プログラムの状態はフレームで表されます。プログラムが一時停止すると、現在のフレームスタックがデバッグツールウィンドウのフレームタブに表示されます。フレームはアクティ

ツールウィンドウ

ツールウィンドウは、プロジェクト構造の表示、アプリケーションの実行とデバッグ、バージョン管理システムやその他の外部ツールとの統合、コード分析、検索、ナビゲーションなどの開発タスクへのアクセスを提供します。デフォルトでは、ツールウィンドウはメインウィンドウの下部と側面に接続されています。ただし、別のモニターなどで別のウィンドウとして使用するために、再配置したり、切り離したりすることもできます。プロジェクトツールウィンドウ、コミットツールウィンドウ、実行ツールウィンドウ、Python コンソールツー...

デバッグコンソールの使用

デバッグコンソールを使用すると、出力とエラーメッセージを表示できます。デバッグコンソールを開く:デバッグセッションを開始すると、PyCharm はデバッグコンソールを起動します。デフォルトでは、コンソールは対話型です。コード補完を使用してコマンドを実行できるプロンプトが表示されます。この動作を無効にするには、「デバッグコンソールを表示」をクリックします。デバッグコンソールで使用できるアクション:コンソールでは、次のことができます。コマンドを入力し、を押して実行します。結果は同じコンソールに

サービスツールウィンドウ

実行 / デバッグ構成:サービスツールウィンドウで複数の実行 / デバッグ構成を管理できます。例: 複数のアプリケーションを開始、一時停止、停止し、それらのステータスを追跡し、アプリケーション固有の詳細を調べることができます。サービスウィンドウに実行 / デバッグ構成を追加するメインメニューからを選択するか、を押します。サービスツールウィンドウで、サービスの追加をクリックし、実行構成タイプを選択します。リストから実行 / デバッグ構成タイプを選択して、このタイプのすべての構成をウィンドウに追...

実行 / デバッグ構成

PyCharm は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。さまざまな起動プロパティを使用して、PyCharm がスクリプトを実行するために使用するさまざまな方法を定義できます。例: 異なる Python インタープリターを使用して同じコードを実行し、さまざまな環境変数のセットを提供し、代替ファイルから入力値を取得できます。実行 / デバッグ構成には...