PyCharm 2026.1 Help

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

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

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

デバッグツールウィンドウの概要
  1. セッション タブ

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

  3. 変数監視

  4. フレーム

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

セッション

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

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

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

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

ツールバー

デバッガーツールバーには、 デバッガーセッションの制御ステップ実行に最もよく使用されるアクションが含まれています。

デバッガーツールバー

好みに応じて、ツールバーで使用できるアクションのリストを構成できます。

デバッガーのツールバーをカスタマイズする

  • デバッグアクションを追加するには、デバッガーツールバーを右クリックし、コンテキストメニューから デバッガーツールバーに追加 を選択して、リストから必要なアクションを選択します。

    デバッガーツールバーのカスタマイズ - アクションの追加
  • デバッグに直接関係のないアクションを追加するには、デバッガーツールバーを右クリックし、コンテキストメニューから ツールバーのカスタマイズ を選択します。

    デバッガーのツールバーのコンテキストメニューの「ツールバーのカスタマイズ」オプション

    開いたダイアログで、 追加 をクリックし、必要なアクションを選択します。

デバッガーツールバー

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

項目

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

説明

再開する。

再実行

Ctrl+F5

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

再開

再開​

F9

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

一時停止​

一時停止

Ctrl + Pause

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

停止

停止

Ctrl+F2

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

ボタンをクリックすると、 ソフトキルが実行され、アプリケーションが SIGINT イベントを受信して正常終了できます(Windows では Ctrl+C​(コピー)​ イベントがエミュレートされます)。 ボタンをクリックすると、 強制終了ボタン に切り替わり、その後にクリックするとアプリケーションの強制終了につながります。例えば Unix では SIGKILL が送信されます。

ブレークポイントの表示

ブレークポイントの表示

Ctrl+Shift+F8

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

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

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

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

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

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

詳細

詳細

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

Show options menu

デバッガー設定

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

項目

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

説明

再開する。

再実行

Ctrl+F5

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

再開

再開​

F9

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

一時停止​

一時停止

Ctrl + Pause

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

停止

停止

Ctrl+F2

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

ブレークポイントの表示

ブレークポイントの表示

Ctrl+Shift+F8

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

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

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

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

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

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

Show options menu

設定

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

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

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

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

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

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

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

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

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

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

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

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

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

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

タブをピン留め​

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

ステップツールバー

項目

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

説明

実行ポイントの表示​

実行ポイントの表示​

Alt+F10

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

ステップオーバー​

ステップオーバー

F8

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

強制ステップオーバー

強制ステップオーバー

Alt+Shift+F8

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

ステップイン​

ステップイン

F7

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

スマートステップイン​

スマートステップイン

Shift+F7

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

Console.WriteLine(Foo(Bar("input") + Baz("input")));

この行には複数の呼び出しがあり、 ステップイン を使用すると、デバッガーはまず Bar() の実装にステップインし、その後 Baz() の実装にステップインします。

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

PyCharm: 選択した呼び出しへのスマートステップ

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

セレクターは、どの呼び出しがすでに実行されたかを示し、これらの呼び出しを再度実行できるようにします。

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

Step into my code

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

Alt+Shift+F7

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

ステップアウト​

ステップアウト

Shift+F8

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

カーソル位置まで実行​

カーソル位置まで実行

Alt+F9

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

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

カーソル位置まで強制実行

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

Ctrl+Alt+F9

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

式の評価

式の評価

Alt+F8

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

項目

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

説明

実行ポイントの表示​

実行ポイントの表示​

Alt+F10

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

ステップオーバー​

ステップオーバー

F8

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

ステップイン​

ステップイン

F7

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

強制ステップイン​

強制ステップイン

Alt+Shift+F7

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

Step into my code

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

Alt+Shift+F7

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

ステップアウト​

ステップアウト

Shift+F8

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

カーソル位置まで実行​

カーソル位置まで実行

Alt+F9

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

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

式の評価

式の評価

Alt+F8

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

レイアウト設定

タブを表示 / 隠す

  1. デバッグ ツールウィンドウの右上隅にある レイアウト設定 をクリックします。

    レイアウト設定
  2. 開いたコンテキストメニューで、表示または非表示にするタブ(ペイン)を選択します。 選択したペインとタブにはチェックマークが表示されます。

タブラベルの表示

このオプションを使用して、デバッガーのタブとペインの名前を表示します。

  1. デバッグ ツールウィンドウの右上隅にある レイアウト設定 をクリックします。

  2. 開いたコンテキストメニューで タブラベルの表示 を選択します。

    タブラベルの表示

デフォルトレイアウトを復元する

デバッグ ツールウィンドウのレイアウトを変更した場合は、デフォルトの状態に復元できます。

  1. デバッグ ツールウィンドウの右上隅にある レイアウト設定 をクリックします。

  2. 開いたコンテキストメニューで デフォルトレイアウトの復元 を選択します。

    デフォルトレイアウトの復元
2026 年 6 月 1 日