PyCharm 2025.1 ヘルプ

Jupyter ノートブックコードセルの実行とデバッグ

ノートブックツールバーのアイコン、コードセルのコンテキストメニューと構造ツールウィンドウのコマンド、およびガターの実行アイコンを使用して、さまざまな方法でノートブックセルのコードを実行できます。

コードセルを実行する

ショートカットとツールバーオプションを使用してコードセルを実行する

  • 次のスマートショートカットを使用して、コードセルをすばやく実行します。

    • Ctrl+Enter : 現在のセルを実行します。

    • Shift+Enter : 現在のセルを実行し、その下のセルを選択します。

    実行が完了すると、セルは編集モードのままになるため、必要に応じて変更したり、実験を続けることができます。

    編集モード中に、Ctrl+Home を押すとキャレットがセルの先頭に移動し、Ctrl+End を押すとキャレットがセルの末尾に移動します。

  • ノートブックのすべてのコードセルを実行するには、ノートブックツールバーRun all をクリックするか、Ctrl+Alt+Shift+Enter を押します。

  • コマンドモード中に、Ctrl+Home を押すとノートブックの最初のセルにフォーカスし、Ctrl+End を押すとノートブックの最後のセルにフォーカスします。

構造ツールウィンドウを使用してコードセルを実行する

  • 単一の Python セルを実行するには、構造ツールウィンドウでそのセルを右クリックし、Run section セルを実行するを選択します。

    Run cell
  • Markdown セクション内のすべてのセルを実行するには、構造ツールウィンドウで Markdown セルを右クリックし、Run section 実行セクションを選択します。

    Run section

セル実行期間

  • セルの実行期間に関する情報は、セルの左下隅に表示されます。

    この領域にマウスを置くと、セルの実行が完了した日時が表示されます。

    The information about the last cell execution

    エラーが発生した場合は、トレースバックノードを展開して、完全なエラーメッセージを表示します。

    Error traceback

サーバーを停止して サーバーまたはカーネルを変更する場合、実行結果は現在のサーバーセッションに対してのみ有効であるため、依存関係を持つすべてのセルを再度実行する必要があります。

変数を表示する

Jupyter コンソール

この機能は、ローカルカーネルとリモートカーネルの両方でデフォルトで有効になっています。リモートカーネルで無効にするには、設定 | ツール | Jupyter | Jupyter 一般カーネルに移動し、サポートライブラリをリモート Jupyter にアップロードチェックボックスをオフにしてください。

ノートブックを実行すると、Jupyter コンソール変数タブで変数をプレビューできます。

Jupyter console: the Variables tab

デフォルトでは、変数は非同期にロードされます。ローディングポリシーを変更するには、変数タブで Manage the loading policy をクリックし、変数ロードポリシーを選択して、利用可能なモードの 1 つを選択します。詳しくは変数の管理ポリシーのロードを参照してください。

配列として表示データフレームとして表示イメージとして表示、またはシリーズとして表示をクリックすると、対応するツールウィンドウにデータが表示されます。詳細については、出力の操作を参照してください。

    Jupyter 変数ツールウィンドウ

    Jupyter 変数ツールウィンドウは、セルを実行するたびに表示されます。このウィンドウを恒久的に非表示にしたい場合は、設定 | ツール | Jupyter | Jupyter 一般に移動し、実行時に変数ツールウィンドウを表示するチェックボックスをオフにしてください。

    Jupyter Variables tool window

      データビジョン

      エディター内で変数を直接プレビューするには、設定 | ツール | Jupyter | Jupyter 一般に移動し、インライン値を表示チェックボックスが有効になっていることを確認します。

      1. ノートブックセルを実行します。変数の値は、その用途の横に表示されます。

        Inline variables in the source editor
        Inline variables in the source editor
      2. 変数をクリックすると、ポップアップに詳細情報が表示されます。

        Preview variables in a popup in the editor

      リファレンスドキュメントのプレビュー

      PyCharm を使用すると、特定の変数、型、または引数に関するリファレンスドキュメントをいつでもすばやくプレビューできます。

      1. 特定のコードセルの要素の参照情報を表示するには、ターゲットコードセル内にキャレットを置き、? <type/variable/argument> と入力します。(この例では、plt.scatter のドキュメントをプレビューします)。コード要素はコードセル内でアクセスできる必要があります。

      2. セルを実行イントロスペクションタブが Jupyter ツールウィンドウに開きます。

        Previewing reference documentation for plt.scatter
      3. イントロスペクションタブでリファレンスドキュメントをプレビューします。

      Jupyter ノートブックのデバッグコード

      PyCharm は、ローカルカーネルとリモート Jupyter サーバーカーネルの両方に Jupyter Notebook デバッガーを提供します。

      1. 選択したセルにブレークポイントを設定し、ノートブックのツールバーで Debug Cell セルのデバッグをクリックします。または、セルを右クリックしてコンテキストメニューからセルのデバッグを選択することもできます。

        Jupyter Notebook デバッガーツールウィンドウが開きます。

        Jupyter Notebook Debugger tool window
      2. ステップツールバーボタンを使用して、次に停止する行を選択します。

        デバッグは単一のコードセル内で実行されます。ただし、コードセルがすでにデバッグされているセルから関数を呼び出す場合は、そのセルにステップインできます。関連するブレークポイントも機能します。関数を含むセルは、実行されるだけでなく、デバッグされる必要があることに注意してください。

        同様に、同じプロジェクト内にある Python ファイルから呼び出される関数にステップインすることもできます。

      3. セルの実行を完了するためのデバッグ手順に進みます。

        Debugging is complete

      ステップアクション

      項目

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

      説明

      デバッガーツールバーで使用可能なアクション。

      Step over

      ステップオーバー

      F8

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

      Step into

      ステップイン

      F7

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

      Step into my code

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

      Alt+Shift+F7

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

      Step out

      ステップアウト

      Shift+F8

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

      デバッガーツールバーの More stepping actions をクリックすると、追加のステップアクションを利用できます。

      Force Step Over

      強制ステップオーバー

      Alt+Shift+F8

      現在のコード行をステップオーバーし、ハイライトされた行にメソッド呼び出しが含まれている場合でも、次の行に移動します。呼び出されたメソッドにブレークポイントがある場合、それらは無視されます。

      Force step into

      強制ステップイン

      Alt+Shift+F7

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

      Smart Step Into

      スマートステップイン

      Shift+F7

      1 行に複数のメソッド呼び出しがあり、どのメソッドを入力するかを具体的に指定したい場合は、スマートステップインが役立ちます。この機能を使用すると、関心のあるメソッド呼び出しを選択できます。

      Run to cursor

      カーソル位置まで実行

      Alt+F9

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

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

      Force Run to Cursor

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

      Ctrl+Alt+F9

      キャレットの位置に達するまで実行を継続します。途中のブレークポイントはすべて無視されます。

      Show Execution Point

      実行ポイントの表示

      Alt+F10

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

      Evaluate expression

      式の評価

      Alt+F8

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

      関連ページ:

      Jupyter ノートブックのサポート

      PyCharm で利用可能な Jupyter Notebook 統合により、ノートブックのソースコードを編集、実行、デバッグし、ストリームデータ、イメージ、その他のメディアを含む実行出力を調べることができます。PyCharm での Notebook のサポートは次のとおりです。コーディング支援: エラーと構文のハイライト。コード補完。行コメントを作成する機能。、Python コンソールで IPython コマンドを実行する機能。専用 Jupyter Notebook デバッガー。Jupyter ノートブ...

      Jupyter ノートブックサーバーの管理

      PyCharm では、次のサーバータイプを使用してコードセルを実行できます。デフォルトサーバー – 現在のプロジェクトのために PyCharm によって自動的に起動される Jupyter サーバー。PyCharm を閉じると終了します。外部サーバー – URL とトークンを指定して接続する Jupyter サーバーであればどれでも使用できます。ローカルマシンでもリモートマシンでも実行できます。外部 Jupyter サーバーを追加へまたは、プロジェクトディレクトリを右クリックし、コンテキストメニューか...

      変数の管理ポリシーのロード

      PyCharm のデバッグモデルでは、変数の値をロードするための 3 つのポリシーが提供されています。同期: 変数はまとめてロードされます。非同期: 変数は別々にロードされます。オンデマンド: 変数はユーザーの要求に応じてロードされます。デフォルトでは、変数は非同期にロードされます。ロードポリシーを変更するには、デバッグツールダイアログボックスのツールバーでクリックし、に移動して、リストからターゲットポリシーを選択します。ロードポリシーの変更は、デバッグプロセスを再実行した後に有効になることに...

      出力の操作

      コードセルを実行すると、その出力が以下に示されます。結果を保存したり、出力をクリアしたりできます。セルの出力を展開したり折りたたんだりすることで、ノートブックの長さを管理できます。セル出力を展開または折りたたむセル出力の横にあるガター内のセルハンドルをクリックします。出力セルのスクロールを無効にする出力セルを右クリックします。出力のスクロールオプションを無効にします。行数を制限せずに出力全体が表示されます。プロットを操作する:プロットをイメージとして保存する出力を右クリックし、コンテキストメニ

      ブレークポイント

      ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:PyChar

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

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