PyCharm 2025.2 ヘルプ

Jupyter ノートブックの作成と編集

Jupyter プロジェクトを作成する

  1. ファイル | 新規プロジェクトに移動します。

  2. Jupyter プロジェクトテンプレートを選択します。

    Creating a new Jupyter project in PyCharm

  3. プロジェクトの場所を選択します。ロケーションフィールドで the Browse button をクリックし、プロジェクトのディレクトリを指定します。プロジェクト名は、指定されたパスのフォルダー名から自動的に取得されます。

  4. プロジェクトを Git バージョン管理下に置くには、Git リポジトリの作成を選択します。

    PyCharm で sample.ipynb ファイルをプロジェクトに追加する場合は、シンプルな Jupyter ノートブックを作成するを選択します。このファイルにはサンプルの Jupyter Notebook が含まれており、ノートブックエディターの UI やその他の機能に慣れるのに役立ちます。

  5. プロジェクトの venv またはベース conda インタープリターを続行する場合は、対応するオプションを選択して、作成をクリックします。

    プロジェクトの venv

    PyCharm は、プロジェクトフォルダー内にシステム Python に基づいて virtualenv 環境を作成します。

    ベース conda

    PyCharm は、conda ベース環境をプロジェクトインタープリターとして構成します。

  6. 別のタイプのインタープリターを構成するか、既存の環境を使用する場合は、カスタム環境を選択します。

    次の手順は、選択内容によって異なります。

    Create a project with a conda environment

    • 環境タイプのリストから Conda を選択します。

    • リストから Python のバージョンを選択します。

    • 環境名を指定します。

    • PyCharm は conda のインストールを検出します。

      PyCharm がインストールを自動的に検出しなかった場合は、conda 実行可能ファイルの場所を指定するか、Conda executable location をクリックして参照します。

    Create a project with virtualenv

    • 環境タイプのリストから Virtualenv を選択します。

    • リストから基本インタープリターを選択するか、Choose the base interpreter をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。

    • ロケーションフィールドに新しい仮想環境の場所を指定するか、Virtual environment location をクリックしてファイルシステム内の場所を参照します。新しい仮想環境のディレクトリは空である必要があります。

    • マシン上のグローバル Python にインストールされているすべてのパッケージを、これから作成する仮想環境に追加する場合は、ベースインタープリターからパッケージを継承するチェックボックスを選択します。このチェックボックスは、virtualenv(英語) ツールの --system-site-packages オプションに対応しています。

    • PyCharm で Python インタープリターを作成するときにこの環境を再利用する場合は、すべてのプロジェクトで使用可能にするチェックボックスを選択します。

    Create a project with Pipenv

    • 環境タイプのリストから Pipenv を選択します。

    • リストから基本インタープリターを選択するか、Browse... をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。

    • ベースバイナリディレクトリを PATH 環境変数に追加した場合、追加のオプションを設定する必要はありません。pipenv 実行可能ファイルへのパスは自動検出されます。

      PyCharm が pipenv 実行可能ファイルを検出しない場合は、pip 経由で pipenv をインストールするをクリックして、PyCharm が自動的にインストールできるようにします。

      または、pipenv のインストール手順に従って実行可能パスを検出し、それをダイアログで指定します。

    Create a project with Poetry

    • 環境タイプのリストから Poetry を選択します。

    • リストから基本インタープリターを選択するか、Browse... をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。

    • PyCharm が Poetry のインストールを検出しない場合は、pip 経由で詩をインストールするをクリックして、PyCharm が Poetry を自動的にインストールできるようにします。

      または、Poetry 実行可能ファイルの場所を指定するか、Browse... をクリックして参照します。

    • プロジェクトディレクトリ内に仮想環境を作成するには、プロジェクト内環境を作成するチェックボックスを選択します。

    Create a project with uv

    • 環境タイプのリストから uv を選択します。

    • リストから Python のバージョンを選択します。

    • 通常、PyCharm は uv のインストールを検出します。

      それ以外の場合は、uv 実行可能ファイルの場所を指定するか、uv executable location をクリックして参照します。

    Create a project with Hatch

    • 環境タイプのリストからハッチを選択します。

    • 通常、PyCharm はハッチのインストールを検出します。

      それ以外の場合は、Hatch 実行可能ファイルの場所を指定するか、uv executable location をクリックして参照します。

    • 環境を選択します。

      Hatch 環境は、プロジェクト固有の様々なタスク用に設計されたワークスペースです。環境が明示的に選択されていない場合、Hatch はデフォルトの環境(英語)を使用します。

    • リストから基本インタープリターを選択するか、Choose the base interpreter をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。

    Selecting an existing conda interpreter for a new project

    既存の conda 環境を再利用するには:

    • タイプを Conda に切り替えます。

    • 環境名を指定します。

    • PyCharm は conda のインストールを検出します。

      PyCharm がインストールを自動的に検出しなかった場合は、conda 実行可能ファイルの場所を指定するか、Conda executable location をクリックして参照します。

    • リストから環境を選択します。conda へのパスを手動で指定した場合は、環境を再ロードする必要がある場合があります。

    Selecting an existing interpreter for a new project

    Virtualenv、Pipenv、Poetry 環境を再利用するには:

    • タイプを Python に切り替えます。

    • リストから Python 実行可能ファイルを選択するか、 をクリックして参照します。

  7. 作成をクリックします。

Jupyter ノートブックを作成して開く

既存の .ipynb ファイルを開くには、他の種類のファイルと同じ手順を実行します。必要に応じて、ノートブックファイルを作成することができます。

ノートブックファイルを作成する

  1. 以下のいずれか 1 つを実行します:

    • プロジェクトツールウィンドウでターゲットディレクトリを右クリックし、コンテキストメニューから新規を選択します。

    • ボタン Alt+Insert

  2. Jupyter Notebook を選択します。

  3. 開いたダイアログで、ファイル名を入力してください。

ノートブックファイルには *.ipynb 拡張子が付いており、対応するアイコン Jupyter でマークされています。

Python ファイルを Jupyter ノートブックに変換する

  1. プロジェクトツールウィンドウでファイルを右クリックします。

  2. コンテキストメニューから Jupyter ノートブックに変換を選択します。

Jupyter ノートブックを Python ファイルに変換する

  1. プロジェクトツールウィンドウでファイルを右クリックします。

  2. コンテキストメニューから Python ファイルに変換するを選択します。

Jupyter ノートブックをエクスポート

Jupyter ノートブックをさまざまな形式でエクスポートできます。

  1. プロジェクトツールウィンドウで Jupyter ノートブックファイルを右クリックします。

  2. ノートブックをエクスポートを選択し、リストから形式を選択します。

    Export a Jupyter notebook file

Jupyter ノートブックを編集する

1 つのセルまたはノートブック全体にさまざまな編集アクションを適用できます。Ctrl+A を 1 回押すとキャレットのセルが選択され、Ctrl+A を 2 回押すとノートブック内のすべてのセルが選択されます。

Jupyter ノートブックのエディターには、編集モードとコマンドモードの 2 つのモードがあります。モードに応じて、ノートブックのセル内のコードを編集したり、キーボードショートカットを使用してセルで特定のアクションを実行したりできます。

モデルの編集

  • 編集モードを切り替えるには、Enter を押すか、任意のセルをクリックします。

  • セルが編集モードの場合、セル内にキャレットが付いたハイライトされた行が表示されます。

    A cell in the edit mode

  • 編集モードでは、Up キーと Down キーを使用してすべてのセルを行ごとに移動できます。

コマンドモード

  • コマンドモードを切り替えるには、Escape を押すか、ガターをクリックします。

  • コマンドモードでは、Up キーと Down キーを使用してノートブックのセルを移動したり、キーボードショートカットを使用してセルを選択、コピー、貼り付け、削除したりできます。

セルの編集

  • 新しく作成されたノートブックには、コードセルが 1 つ含まれています。セルの種類を変更するには、セルを右クリックし、コンテキストメニューから「セルを Markdown に変換する」または「セルを SQL に変換する」を選択します。

  • コードセルを編集するには、それをクリックするだけです。

  • Markdown セルを編集するには、セルをダブルクリックするか、Enter を押して入力を開始します。出力をプレビューするには、Shift+Enter を押します。

Markdown セルツールバー

  1. Markdown セル内のテキストの一部を選択すると、ツールバーが表示されます。

    Markdown cell toolbar

  2. これを使用して、次のフォーマットオプションを適用できます。

    項目

    アイコン

    ショートカット

    説明

    テキストスタイル

    ドロップ下へをクリックして、テキストの書式をさまざまな見出しレベルに変更します。

    太字テキスト

    Bold text

    Ctrl+B

    選択したテキストを太字にします (**text**)。

    斜体テキスト

    Italic text

    Ctrl+I

    選択したテキストを斜体 (_text_) にします。

    取り消し線

    Strike through

    Ctrl+I

    選択したテキストに取り消し線を引きます。(~~text~~)。

    コード

    Code

    Ctrl+Shift+C

    テキストをインラインコードとしてフォーマットします。

    リンクの作成

    Create link

    Ctrl+Shift+U

    ハイパーリンクを追加します。

    順序なしリスト

    Unordered list

    リストを作成します。次のいずれかの種類を選択できます。

    • 順序なしリスト

    • 順序付きリスト

    • チェックマークリスト

ノートブックのセルを操作する

セルを追加する

  • 選択したセルの上にコードセルを追加するには、次のいずれかを実行します。

  • 選択したセルにコードセルを追加するには、次のいずれかを実行します。

    Adding a notebook cell

  • セル間のポップ上へを使用して、code、Markdown、SQL または AI セルをノートブックに追加します。

    Popup between Jupyter notebook cells

    ノートブック内の 2 つのセルの間にマウスを移動すると、ポップ上へが自動的に表示されます。

セルを選択

  • セルを選択するには、セルの横にあるガターをクリックします。

  • 複数のセルを選択するには:

    • 一連の連続するセルの場合は Shift を押したまま、連続していないセルの場合は Ctrl を押しながら、セルの隣のガターをクリックします。

    • コマンドモードで、Shift キーを押しながら、Up キーと Down キーを押します。

選択したセルに対して、実行、コピー、結合、展開、コメント、削除を行うことができます。

セルをドラッグアンドドロップ

ノートブックのセルを並べ替えるには:

  1. セルの横のガターにあるセルハンドルをクリックして押したままにします。

    Cell handle

  2. セルを必要な位置にドラッグし、マウスボタンを放してハイライトされた領域にドロップします。

セルをコピーして貼り付ける

  • コマンドモードでセルをコピーするには、Ctrl+C、C を押すか、セルツールバーのコンテキストメニューで Copy cell セルをコピーを選択します。

  • コピーしたセルを下に貼り付けるには、Ctrl+V または V を押します。

  • 現在のセルの上に貼り付けるには、Ctrl+V/Shift+V で Shift を押します。

  • セルのコンテキストメニューから必要なアクションを選択することもできます。

セルを分割して結合する

  • 現在のセルをその下のセルと結合するには、セルを右クリックし、コンテキストメニューから下のセルをマージコマンドを選択します。

    同様に、選択したセルの上のセルを対応するコマンドで結合できます。

  • セルを 2 つのセルに分割するには、分割する行にキャレットを置き、右クリックしてコンテキストメニューからセルの分割を選択します。

セルの展開と折りたたみ

  • セルを展開または折りたたむには、セルの横のガターにあるセルハンドルをクリックします。

    Expanded notebook cell
    Collapsed notebook cell

  • Markdown セル見出しの横にあるシェブロンをクリックすると、下のコードセルを折りたたんだり展開したりできます。折りたたまれたセルの数は見出しに表示されます。

    Expanded notebook cells
    Collapsed notebook cells

セルをコメントアウトする

  • アクティブセルをコメントアウトするには、コマンドモードに切り替えて Ctrl+/ を押します。

  • 複数のセルをコメントアウトするには、コマンドモードで選択し、Ctrl+/ を押します。

セルを削除する

  • セルツールバーの Delete Cell セルを削除をクリックします。

  • セルを右クリックして、コンテキストメニューからセルを削除を選択します。

セルタグを追加

ノートブックエディターで各セルにタグを割り当てたり表示したりできます。

  1. セルツールバーの More をクリックします。

  2. コンテキストメニューからセルタグを追加を選択します。

    Cell tag added

  3. タグを入力し、確認をクリックします。

タグを削除するには、タグを右クリックしてタグの除去を選択します。

重複セル

  • セルを複製するには、セルツールバーの「 More 」をクリックし、コンテキストメニューから「下のセルを複製」を選択します。新しいセルは元のセルのすぐ下に表示されます。

  • セルを右クリックして、コンテキストメニューから下のセルを複製を選択します。

コーディング支援を利用する

構文のハイライトやコード補完などの Python コードインサイトを使用して、コードセルを編集できます。

  • PyCharm は、クラス、関数、変数の名前に対してコード補完を有効にします。コード構成の名前の入力を開始すると、候補リストが表示されます。

    Function completion
    Class variable completion
    Path completion
    Package completion
    DataFrame column name completion

  • インテンションアクションとクイックフィックス。インテンションアクションを使用して、不足しているインポートを追加できます。

    Quick-fix for the missing import

    現在のセルまたはノートブックの最初のセルにインポートステートメントを追加できることに注意してください。

配色をカスタマイズする

好みや習慣に応じて、ノートブック対応の構文ハイライトを設定できます。

  1. 設定ダイアログ（Ctrl+Alt+S）で、エディター | カラースキームの切り替え | Jupyter ノートブックに移動します。

  2. 配色を選択するか、デフォルトから継承されたハイライト設定を受け入れるか、色とフォントの説明に従ってカスタマイズします。

特定の Notebook 要素の色を調整する方法の詳細については、Jupyter ノートブックのカラースキームを参照してください。

    2025 年 8 月 11 日
    Jupyter ノートブックのサポート Jupyter ノートブックコードセルの実行とデバッグ

    関連ページ：

    Git リポジトリのセットアップ

    既存の Git リポジトリのクローンを作成するか、既存のプロジェクトを Git バージョンコントロール下に置くと、PyCharm はコンピューターに Git がインストールされているかどうかを自動的に検出します。IDE が Git 実行可能ファイルを見つけられない場合、それをダウンロードすることを提案します。PyCharm は、Windows10 バージョン 2004 で使用可能な Windows Subsystem for Linux 2 (WSL2) の Git をサポートします。Git が...

    Pipenv 環境を構成する

    Pipenv は、Python プロジェクトの仮想環境を作成するために必要なすべての手段を提供するツールです。パッケージをインストールまたはアンインストールすると、Pipfile ファイルを介して自動的にプロジェクトパッケージが管理されます。Pipenv は Pipfile.lock ファイルも生成します。このファイルは、確定的なビルドを作成し、作業環境のスナップショットを作成するために使用されます。これは、セキュリティが重視されるデプロイにおいて、プロジェクトの要件やパッケージのバージョンが重要な場合...

    エディターでファイルを開く

    PyCharm で行うことは何でも、プロジェクトのコンテキストで行います。PyCharm では、プロジェクトを作成したり、リポジトリからクローンしたり、既存のソースからインポートしたりできます。プロジェクトを開くと、そのファイルを操作できます。編集のためにファイルを開く以下のいずれか 1 つを実行します: いずれかのツールウィンドウで目的のファイルをダブルクリックします。いずれかのツールウィンドウで目的のファイルを選択し、を押します。いずれかのツールウィンドウで目的のファイルを選択し、コンテキス...

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

    ノートブックツールバーのアイコン、コードセルのコンテキストメニューと構造ツールウィンドウのコマンド、およびガターの実行アイコンを使用して、さまざまな方法でノートブックセルのコードを実行できます。コードセルを実行する：ショートカットとツールバーオプションを使用してコードセルを実行する次のスマートショートカットを使用して、コードセルをすばやく実行します。現在のセルを実行します。現在のセルを実行し、その下のセルを選択します。実行が完了すると、セルは編集モードのままになるため、必要に応じて変更

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

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

    コード補完

    基本コード補完は、可視性スコープ内のクラス、メソッド、キーワードの名前を補完するのに役立ちます。PyCharm はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します。候補にはライブテンプレートも含まれます。補完機能は英語以外のキーボードレイアウトでも利用できます。基本補完を呼び出すデフォルトでは、PyCharm は入力時に自動的にコード補完ポップアップを表示します。あるいは、を押すか、メインメニューからを選択することもできます。基本コード補完を 2 回呼び出すと、依存関...