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

PyCharm で利用可能な Jupyter Notebook 統合により、ノートブックのソースコードを編集、実行、デバッグし、ストリームデータ、画像、その他のメディアを含む実行結果を確認できます。

PyCharm でのノートブックサポートには以下が含まれます：

コーディング支援:
- エラーと構文のハイライト。
- コード補完。
- 行コメント Ctrl+/ を作成する機能。
IPython コマンドを Python コンソールで実行する機能。
専用 Jupyter Notebook デバッガー。
Jupyter ノートブックを使った基本操作のためのショートカット。
.ipynb ファイルを認識し、アイコンでマークする機能。
Jupyter プロジェクトテンプレート。
Jupyter 固有の AI 機能。

始める前

Jupyter Notebook のすべての機能を正しく利用するには、設定 | プラグインページのインストール済みタブで Markdown プラグインが有効になっていることを確認してください。詳細については、プラグインの管理を参照してください。

クイックスタート

PyCharm で Jupyter ノートブックの使用を始めるには：

Jupyter プロジェクトを作成します。
作成または .ipynb ファイルを開きます。
追加および編集ソースセル
いずれかのコードセルを実行して、Jupyter サーバーを起動します。

ユーザーインターフェースに慣れる

Jupyter ノートブックツールバーを使用すると、ノートブックのすべての基本操作にすばやくアクセスできます。

アクションを追加、削除、並べ替えることでツールバーをカスタマイズできます。

ノートブックツールバーの詳細をクリックします。
次のいずれかを実行します：
- ツールバーのカスタマイズを選択し、リストからアクションを選択します。ツールバーに追加されます。
- ツールバーのカスタマイズ | Jupyter ツールバーをカスタマイズ ... を選択すると、追加のアクションを追加または削除できるダイアログが開きます。詳細については、メニューとツールバーを参照してください。

項目	説明
下のコードセル	選択したセルにコードセルを追加します。
セルを上に移動	現在のセルを上に移動します。
セルを下に移動	現在のセルを下に移動します。
セルを実行して下を選択	このセルを実行し、下のセルを選択します。下にセルがない場合は、PyCharm によって作成されます。
すべて実行	ノートブックのすべてのセルを実行します。
カーネルを再起動	このアイコンをクリックして、現在実行中のカーネルを再起動します。
すべての出力をクリア	ノートブック内のすべての出力をクリアします。
Gist を作成	Gist を作成ダイアログを開きます。
	このウィジェットをクリックすると、最後に実行されたセルに移動します。
	現在使用されている Jupyter サーバーを表示します。このウィジェットをクリックして Jupyter サーバーの構成を選択すると、別のローカルサーバーまたはリモート Jupyter サーバーがセットアップされます。
Jupyter コンソールを開く	Jupyter コンソールタブを Jupyter ツールウィンドウで開きます。このボタンは、現在のノートブックの Jupyter サーバーを起動すると有効になります。
追加アクション
セルタイプセレクター	選択したセルの種類を表示します。クリックして別の種類を選択し、それに応じてセルを変換します。
セルを削除	現在のセルを削除します。
セルをデバッグ	選択したセルのデバッグを開始します。
上のセルを選択	上のセルを選択します。
下のセルを選択	下のセルを選択します。
ブラウザーでノートブックを開く	現在のノートブックをブラウザーで開きます。

セル

セルには、コードまたは Markdown テキストのいずれかが含まれます。コードセルを実行すると、コード実行の結果であるセル出力を表示できます。

各セルには専用のツールバーがあり、必要な操作にすばやくアクセスできます。デフォルトでは、セルにカーソルを合わせると表示されます。

選択したセルにツールバーを常に表示させることもできます。そのためには、設定 | Jupyter | Jupyter 一般に移動し、選択したセルのツールバーを表示するオプションを有効にしてください。

長いセルの場合、スクロール中もエディターの右上隅にツールバーを表示したままにすることができます。そのためには、設定 | Jupyter | Jupyter 一般に移動し、セルツールバー固定チェックボックスを選択してください。

セルツールバーは次の要素で構成されます。

ツールバーで直接実行できるアクション。
コンテキストメニューの追加アクション。コンテキストメニューを開くには、セルツールバーのをクリックします。

ツールバーとコンテキストメニューで使用できるアクションは、セルの種類によって異なります。

項目	説明
ツールバーアクション
AI 編集セル	コードの提案や改善について AI による支援を受けられます。
デバッグセル	セル内のコードをデバッグします。
セルの削除	現在のセルを削除します。
コンテキストメニューのオプション
セルの上を実行	現在のセルの上のセルを実行します。
セル以下を実行	現在のセルとその下のセルを実行します。
セルを上に移動	現在のセルを上に移動します。
セルを下に移動	現在のセルを下に移動します。
上のセルをマージ	現在のセルを上のセルと結合します。
下のセルをマージ	現在のセルをその下のセルと結合します。
セルの分割	キャレット位置でセルを 2 つに分割します。
下のセルを複製	現在のセルを複製し、そのコピーを下に挿入します。
セルをコピー	セルをコピーしてクリップボードに追加します。
セルを切り取る	セルを削除してクリップボードに追加します。
セルを Markdown に変換する	現在のセルのタイプを Markdown に変更します。
セルを SQL に変換する	現在のセルのタイプを SQL に変更します。
セルタグを追加	セルを整理または管理するにはタグを追加します。
出力のクリア	セルの出力をクリアします。

項目	説明
ツールバーアクション
AI 編集セル	コードの提案や改善について AI による支援を受けられます。
編集	編集モードに切り替えます。
ランセクション	Markdown セクション内のすべてのセルを実行します。
セルの削除	現在のセルを削除します。
コンテキストメニューのオプション
セルタグを追加	セルを整理または管理するにはタグを追加します。
下のセルを複製	現在のセルを複製し、そのコピーを下に挿入します。
セルを上に移動	現在のセルを上に移動します。
セルを下に移動	現在のセルを 1 つ下に移動します。
セルをコピー	セルをコピーしてクリップボードに追加します。
セルを切り取る	セルを削除してクリップボードに追加します。

項目	説明
ツールバーアクション
AI 編集セル	コードの提案や改善について AI による支援を受けられます。
デバッグセル	セル内のコードをデバッグします。
セルの削除	現在のセルを削除します。
コンテキストメニューのオプション
セルの上を実行	現在のセルの上のセルを実行します。
セル以下を実行	現在のセルとその下のセルを実行します。
セルを上に移動	現在のセルを上に移動します。
セルを下に移動	現在のセルを下に移動します。
上のセルをマージ	現在のセルを上のセルと結合します。
下のセルをマージ	現在のセルをその下のセルと結合します。
セルの分割	キャレット位置でセルを 2 つに分割します。
下のセルを複製	現在のセルを複製し、そのコピーを下に挿入します。
セルをコピー	セルをコピーしてクリップボードに追加します。
セルを切り取る	セルを削除してクリップボードに追加します。
セルを Markdown に変換する	現在のセルのタイプを Markdown に変更します。
セルタグを追加	セルを整理または管理するにはタグを追加します。
出力のクリア	セルの出力をクリアします。

Ctrl+Alt+S を押して設定を開き、外観 & 振る舞い | メニューおよびツールバーを選択します。
または、ツールバーのをクリックし、セルツールバーのカスタマイズを選択します。
Jupyter セルツールバーをカスタマイズするでアクションを追加または削除します。
詳細については、メニューとツールバーを参照してください。
変更を適用してウィンドウを閉じるには OK をクリックし、ウィンドウを開いたままにするには適用をクリックします。

Jupyter ツールウィンドウ

Jupyter サーバーのいずれかを起動すると、 Jupyter ツールウィンドウが表示されます。このウィンドウのサーバータブには、Jupyter サーバーの現在の状態と、ブラウザーで表示されるノートブックへのリンクが表示されます。

また、実行中のサーバー（）を停止したり、停止したサーバー（）を起動したりするためのコントロールも提供されます。

Jupyter コンソール

Jupyter コンソールでは以下のコマンドを実行できます:

ノートブックツールバーの Jupyter コンソールを開くをクリックします。このボタンは、現在のノートブックの Jupyter サーバーを起動すると有効になります。ノートブックファイルごとに 1 つのコンソールを開くことができます。
コマンドまたは一連のコマンドを入力し、コンソールツールバーのを押します。

変数タブは、実行されたセルの変数値に関する詳細なレポートを提供します。このタブは、Jupyter コンソールを起動すると自動的に開きます。

Jupyter 変数ツールウィンドウ

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

Jupyter 変数ツールウィンドウでは、変数の値を表示したり、変数のリストを管理したりできます。

コードセルを再実行せずに変数のリストをリフレッシュするには、変数をリフレッシュをクリックします。
変数を名前または型で並べ替えるには、並べ替えをクリックし、リストから必要なオプションを選択します

構造ツールウィンドウ

.ipynb ファイルの場合、 Markdown セルと Python セルの両方を構造ツールウィンドウに表示できます。

Markdown セルは、見出しテキストをラベルとして使用して表示されます。構造ビューには、見出しを含む Markdown セルのみが含まれます。
デフォルトでは、構造ツールウィンドウ内の Markdown 見出しのみに番号が付けられます。
番号設定を構成するには、ツールウィンドウのツールバーでビューオプションをクリックし、次に見出し番号を表示をクリックします。
構造ツールウィンドウは、Markdown 見出し (たとえば、 # Heading level 1) と、適切な閉じタグを持つ HTML 見出し (たとえば、 <h1>Heading level 1</h1>) を認識します。
構造ツールウィンドウに Python セルを表示するには、ツールウィンドウのツールバーでビューオプションをクリックし、次に Python セルを表示をクリックします。以下のいずれかのオプションを選択できます：
- すべて: すべてのコードセルを表示します。
- コメントあり：コメントで始まるコードセルのみを表示します。コメントはセルラベルとして使用されます。
- なし: コードセルを表示しません。
構造ツールウィンドウは、コードセルのクラス、関数、その他の要素を表示します。