Django 構造ツールウィンドウ

Django プラグインを有効化

この機能は、Django プラグインに依存しており、PyCharm にはデフォルトでバンドルされて有効になっています。関連機能が利用できない場合は、プラグインが無効になっていないことを確認してください。

Ctrl+Alt+S を押して設定を開き、プラグインを選択します。
インストール済みタブを開き、 Django プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。

Django の構造ツールウィンドウは、Django プロジェクトの主要コンポーネントを作成、リファクタリング、移動するための迅速な方法を提供します。

プロジェクト構造を表示する

左側の Django の構造をクリックしてツールウィンドウを開きます。
ツールウィンドウのアイコンが表示されない場合は、 More tool windows をクリックし、リストから Django の構造を選択します。
Django の構造ツールウィンドウには、次のコンポーネントがリストされます。
- モデル
- 管理者クラス
- ビュー
デフォルトでは、すべてのコンポーネントが表示されます。コンポーネントを非表示にするには、ツールバーでビューオプションをクリックし、表示セクションで選択を解除します。
デフォルトでは、コンポーネントはコンポーネントタイプ別にグループ化されます。アプリ別にグループ化するには、ツールバーでビューオプションをクリックし、アプリを選択します。
コンポーネントに移動するには、それをダブルクリックします。含まれているファイルがエディターで開かれ、キャレットが対応するクラス宣言または関数定義に設定されます。

プロジェクト設定にアクセスする

Django の構造ツールウィンドウで、設定をダブルクリックします。 Django プロジェクト設定ファイル (たとえば、 settings.py ) がエディターで開きます。

アプリの管理

Django の構造ツールウィンドウを使用して、新しいアプリを作成し、移行を実行できます。

アプリを作成する

次のいずれかを実行します：
- Django の構造ツールウィンドウのツールバーで新しい Django アプリをクリックします。
- 既存のアプリを右クリックします。アプリがまだない場合は、アプリを作成リンクをクリックします。
  コンテキストメニューから新しい Django アプリを選択します。
開いたターミナルでアプリ名を指定し、 Enter を押します。

アプリの移行を実行する

Django の構造ツールウィンドウでアプリを右クリックし、コンテキストメニューから移行を行うを選択します。
アプリ名は開いたターミナルに自動で入力されます。 Enter
を押します。
Django の構造ツールウィンドウに戻り、アプリを右クリックし、コンテキストメニューからマイグレーションを選択します。
アプリ名は開いたターミナルに自動で入力されます。ボタン Enter

アプリディレクトリに移動する

Django の構造ツールウィンドウでアプリを右クリックし、コンテキストメニューからプロジェクトビューで開くを選択します。
アプリディレクトリが Project ツールウィンドウで開きます。

モデルの管理

Django の構造ツールウィンドウを使用すると、モデルに対して次の操作を実行できます。

新しいモデルを追加からアプリ
管理インターフェースでモデルを登録する
モデル管理クラスからモデルに移動する
モデルのリファクタリング
プロジェクト内のモデルの使用箇所を見つける

モデルを作成する

Django の構造ツールウィンドウで、モデルノードまたは既存のモデルを右クリックします。
コンテキストメニューから新しいモデルを選択します。
アプリにモデルを含む複数のファイル、たとえばディレクトリや Python モジュールがある場合、PyCharm は新しいモデル用のファイルを選択するように促します。
モデルを含むファイル ( models.py など) がエディターで開きます。
新しいモデルの名前を指定して Enter を押すと、 pass の代わりにフィールドと他のモデルコードを追加して続行できます。

管理インターフェースでモデルを登録する

Django の構造ツールウィンドウでモデルを右クリックし、コンテキストメニューから Django 管理者に登録するを選択します。
admin.py がエディターで開かれ、 @admin.register デコレーターを備えた新しいモデル管理クラスが追加されます。
Enter を押してクラスの作成を確認します。

モデルが管理インターフェースに登録されると、対応するモデル管理クラスが Django の構造ツールウィンドウの管理ノードにリストされます。

プロジェクトにモデルの登録にまだ使用されていないモデル管理クラスが含まれている場合、それらは Django の構造ツールウィンドウでグレー表示されます。

コンテキストメニューを使用して、モデルをそのようなモデル管理クラスに登録できます。

未使用の管理者にモデルを登録する

Django の構造ツールウィンドウでモデル管理クラスを右クリックし、コンテキストメニューから Django 管理者に登録するを選択します。
ポップアップでモデルを選択します。未登録のモデルがない場合は、全モデル登録済みメッセージが表示されます。
admin.py がエディターで開かれ、 @admin.register デコレーターがモデル管理クラスに追加されます。

管理ノードのモデル管理クラスのコンテキストメニューを使用して、モデル管理クラスの使用箇所を検索し、リファクタリングし、対応するモデルに移動することもできます。

管理者からモデルに移動する

Django の構造ツールウィンドウでモデル管理クラスを右クリックし、コンテキストメニューからモデルに移動を選択します。
選択した管理クラスに複数のモデルが登録されている場合は、ポップアップでモデルを選択する必要があります。

モデルをリファクタリングする

Django の構造ツールウィンドウでモデルを右クリックします。
開いたコンテキストメニューでリファクタリングを選択し、リストからリファクタリングを選択します。

モデルの使用方法を見つける

Django の構造ツールウィンドウでモデルを右クリックし、コンテキストメニューから使用箇所の検索を選択します。
「検索」ツールウィンドウが開き、検索結果が表示されます。詳細については、プロジェクトの使用箇所を見つけるを参照してください。

ビューの管理

Django の構造ツールウィンドウを使用すると、ビューを使用して次の操作を実行できます。

新しいビューを作成する
ビューのリファクタリング
プロジェクト内のビューの使用箇所を見つける

ビューを作成する

Django の構造ツールウィンドウで、ビューノードまたは既存のビューを右クリックします。
コンテキストメニューから新しいビューを選択します。
ビューの種類を選択します。
アプリに複数のビューを含むファイルがある場合、PyCharm は新しいビュー用のファイルを選択するように求めます。
ビューを含むファイル ( views.py など) がエディターで開かれます。
新しいビューの名前を指定して Enter を押すと、ビューコードの追加に進むことができます。

ビューのリファクタリング

Django の構造ツールウィンドウでビューを右クリックします。
開いたコンテキストメニューでリファクタリングを選択し、リストからリファクタリングを選択します。

ビューの使用方法を見つける

Django の構造ツールウィンドウでビューを右クリックし、コンテキストメニューから使用箇所の検索を選択します。
「検索」ツールウィンドウが開き、検索結果が表示されます。詳細については、プロジェクトの使用箇所を見つけるを参照してください。

2026 年 6 月 1 日