PyCharm 2026.1 Help

実行 / デバッグ構成: Django テスト

Django プラグインを有効化

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

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン​ を選択します。

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

作成: Run | Edit Configurations | 新規構成の追加| Django テスト

このダイアログを使用して、 Django テスト実行 / デバッグ構成を作成します。

ツールバー

実行 / デバッグ構成のツリー表示には、project で使用可能な構成の管理や、デフォルトの構成テンプレートの調整に役立つツールバーがあります。

項目

ショートカット

説明

追加ボタン

Alt+Insert

実行 / デバッグ構成を作成します。

削除ボタン

Alt+Delete

選択した実行 / デバッグ構成を削除します。 デフォルト設定は削除できません。

コピー

Ctrl+D

選択した実行 / デバッグ構成のコピーを作成します。 デフォルト設定のコピーを作成してください。

構成を保存

このボタンは、 一時的な構成を選択した場合にのみ表示されます。 このボタンをクリックして、一時的な構成を永続的なものとして保存します。

新しいフォルダーに移動 / 新しいフォルダーを作成

新しいフォルダーに移動 / 新しいフォルダーを作成します。 実行 / デバッグ構成は、 フォルダーに配置することでグループ化できます。

フォルダーを作成するには、カテゴリ内の設定を選択し、 フォルダー をクリックしてフォルダー名を指定します。 カテゴリだけにフォーカスがある場合は、空のフォルダーが作成されます。

次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは 上へ移動 ボタンと 下へ移動 ボタンを使用します。

グループ化を解除するには、フォルダーを選択して 構成の除去 をクリックします。

構成の並べ替え

このボタンをクリックすると、設定がアルファベット順にソートされます。

共通オプション

項目

説明

名前

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

Allow multiple instances

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、PyCharm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。 これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

プロジェクトファイルとして保存

実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。 デフォルトの場所は .idea/runConfigurations です。 ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

デフォルトでは無効になっており、PyCharm は実行構成設定を .idea/workspace.xml に保存します。

Django テスト固有のオプション

項目

説明

ターゲット

実行するターゲットを指定します。 フィールドが空の場合、 INSTALLED_APPS で指定されたすべてのアプリケーションのすべてのテストが実行されることを意味します。

  • 特定のアプリケーションでテストを実行する場合は、アプリケーション名を指定します。

  • 特定のテストケースを実行するには、アプリケーション名の後にその名前をドットで区切って指定します。

  • テストケース内で単一のテストメソッドを実行するには、ドットの後にテストメソッド名を追加します。

テストターゲットに含まれる doctest にも同じルールが適用されます。 テストラベルは、実行するテストメソッドまたはクラスへのパスとして使用されます。 doctest を持つ関数、またはクラスレベルの doctest を持つクラスがある場合は、ラベルにテストメソッドまたはクラスの名前を追加することでそのテストを呼び出すことができます。

カスタム設定

このチェックボックスをオンにすると、Django テストはデフォルトのテストではなく、指定されたカスタム設定で実行されます。

Django 設定を含むファイルの完全修飾名を指定します。 右側のテキストフィールドに手動で入力するか、参照ボタンをクリックして、 表示されるダイアログでいずれかを選択できます。

このチェックボックスが選択されていない場合、Django テストは Django のサポート ページの 設定 フィールドで定義されているデフォルト設定で実行されます。 テキストフィールドは無効です。

オプション

このチェックボックスを選択すると、Django テストに渡すパラメーターを指定することができます。 右側のテキストフィールドにパラメーターのリストを入力し、パラメーターに ' - ' を付け、区切り文字としてスペースを使用します。 例:

--noinput --failfast

このチェックボックスを選択しないと、テキストフィールドは無効になります。

環境変数

このフィールドには、環境変数のリストが表示されます。 リストに複数の変数が含まれている場合、それらはセミコロンで区切られます。

デフォルトでは、フィールドには 1 に設定された変数 PYTHONUNBUFFERED が含まれています。 リストに入力するには、参照ボタンをクリックするか、 Shift+Enter を押して、 環境変数 ダイアログで目的の環境変数のセットを指定します。

新しい変数を作成するには、 追加ボタン をクリックして、目的の名前と値を入力します。

テキストファイルに一連のレコードとして格納されている変数をリストに追加することができます。

Variable1 = Value1 Variable2 = Value2

テキストファイルから変数リストをコピーして、 環境変数 ダイアログ内の 貼り付け貼り付け )をクリックします。 変数がテーブルに追加されます。 タスクを完了するには、 OK or Ok をクリックします。 いつでも 環境変数 ダイアログ内で全変数を選択し、 コピー コピー をクリックして、テキストファイルに貼り付けることができます。

Python インタープリター

リストから事前設定された Python インタープリターの 1 つを選択してください。

インタープリターオプション

このフィールドで、インタープリターに渡される コマンドラインオプション(英語)を指定します。 必要に応じて、 Expand the field をクリックし、エディターに文字列を入力します。

作業ディレクトリ

実行中のタスクが使用するディレクトリを指定します。

  • デフォルトの実行 / デバッグ構成がキーボードショートカット Ctrl+Shift+F10 によって、またはスクリプトのコンテキストメニューから 実行 を選択することによって作成されるとき、作業ディレクトリは実行可能スクリプトを含むものです。 このディレクトリはプロジェクトディレクトリとは異なる場合があります。

  • このフィールドを空白のままにすると、PyCharm インストールの bin ディレクトリが使用されます。

このフィールドでは パス変数を使用できます。

PYTHONPATH にコンテンツルートを追加する

このチェックボックスを選択すると、プロジェクトのすべての コンテンツルートが環境変数 PYTHONPATH に追加されます。

PYTHONPATH にソースルートを追加する

プロジェクトのすべての ソースルートを環境変数 PYTHONPATH に追加するには、このチェックボックスを選択してください。

Docker コンテナーの設定

参照ボタン をクリックしてダイアログを開き、以下の設定を指定します。

オプション

  • すべてのポートを公開する: すべてのコンテナーポートをホストに公開します。 これはオプション --publish-all に対応します。

  • ポートバインディングポートバインディングのリストを指定します。 docker run-p オプションを使用するのと同様です。

  • ボリュームバインディング: このフィールドを使用して、特別なフォルダー (ボリューム) と、Docker デーモンが実行されるコンピューターのフォルダー間のバインドを指定します。 -v オプションに対応します。 詳細については、「コンテナー内のデータを管理する(英語) 」を参照してください。

  • 環境変数: このフィールドを使用して、環境変数とその値のリストを指定します。 -e オプションに対応します。 詳細については、「ENV (環境変数)(英語) 」を参照してください。

  • 実行オプション: このフィールドを使用して、 Docker コマンドラインオプション(英語)を指定します。

をクリックしてテーブルを展開します。 をクリックしてリストを作成します。

Docker Compose

コマンドとオプション

Docker Compose コマンドラインインターフェースの次のコマンドを使用できます。

コマンド

サポートされているオプション

up(英語): サービスのコンテナーをビルド、作成、開始、アタッチします。

  • --abort-on-container-exit

  • --build

  • --exit-code-from SERVICE

  • --scale SERVICE=NUM...

  • --timeout TIMEOUT

run(英語): サービスに対して 1 回限りのコマンドを実行します。

  • --entrypoint CMD

  • -l, --label KEY=VAL

  • --name NAME

  • -p, --publish=[]

  • --rm

  • --service-ports

  • --use-aliases

  • -u, --user=""

  • -v, --volume=[]

exec(英語): サービスで任意のコマンドを実行します。

  • --index=index

  • --privileged

  • -u, --user USER

コマンドプレビュー

このフィールドを使用して、完全なコマンド文字列をプレビューします。

例: コマンドとオプション フィールドの up --build exec --user jetbrains の組み合わせは、プレビューで次の出力を生成します。

docker compose -f C:\PyCharm-2019.2\Demos\djangodocker-master\docker-compose.yml <override configuration file> up --build exec --user jetbrains

ログ

これらの設定を使用して、実行中またはデバッグ中に生成されるログファイルをコンソール、つまり 実行または デバッグツールウィンドウ の専用タブに表示するかを指定します。

ログ フィールドを有効にする方法については、 ログオプションの設定 を参照してください。

項目

説明

アクティブ

この列のチェックボックスを選択すると、ログエントリが Run tool windowまたは デバッグツールウィンドウ の対応するタブに表示されます。

ログファイルエントリ

この列の読み取り専用フィールドには、表示するログファイルの一覧が表示されます。 リスト

  • 特定のファイルへのフルパス。

  • 完全なパスやパターンを代用する別名。 これらのエイリアスは、対応するログファイルが表示されているタブのヘッダーにも表示されます。

    ログエントリパターンで複数のファイルが定義されている場合、タブヘッダーにはログエントリエイリアスではなくファイルの名前が表示されます。

内容のスキップ

選択したログの以前の内容をスキップするには、このチェックボックスを選択します。

コンソール出力をファイルに保存する

このチェックボックスを選択して、コンソール出力を指定した場所に保存します。 パスを手動で入力するか、参照ボタンをクリックして、 表示されるダイアログで目的の場所をポイントします。

メッセージが標準出力ストリームに出力されたときにコンソールを表示する

関連付けられているプロセスが Standard.out に書き込んだ場合は、このチェックボックスをオンにして出力コンソールをアクティブにして前面に表示します。

メッセージがエラー出力ストリームに出力されたときにコンソールを表示する

関連付けられているプロセスが Standard.err に書き込んだ場合は、このチェックボックスをオンにして出力コンソールをアクティブにして前面に表示します。

追加ボタン

このボタンをクリックすると Edit Log Files Aliases dialogが開き、新しいログエントリを選択してエイリアスを指定できます。

編集ボタン

このボタンをクリックすると、 Edit Log Files Aliases dialog内で選択したログファイルエントリのプロパティを編集できます。

削除ボタン

選択したログエントリをリストから削除するには、このボタンをクリックします。

参照ボタン

このボタンをクリックすると、選択ログファイルのエントリを編集できます。 このボタンは、項目が選択されている場合にのみ使用できます。

起動前

この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。 タスクは、リストに表示されている順序で実行されます。

項目

ショートカット

説明

追加ボタン

Alt+Insert

このアイコンをクリックして、以下の利用可能なタスクのいずれかを追加します:

  • Launch Web Browser: ブラウザーを起動するには、このオプションを選択します。 開いたダイアログで、ブラウザーの種類を選択し、開始 URL を指定します。 また、ブラウザーを JavaScript デバッガーで起動するかどうかも指定します。

  • 外部ツールの実行: 外部アプリケーションを実行することを選択します。 開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 PyCharm でまだ定義されていない場合は、その定義を追加してください。 詳細については、 外部ツール外部ツール を参照してください。

  • Run Another Configuration: 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。 複数の構成を並行して実行する場合は、 複合実行 / デバッグ構成を使用してください。

  • Run File Watchers :このオプションを選択すると、PyCharm が現在アクティブなすべての File Watchers を適用します。

  • Run Remote External Tool: リモート SSH 外部ツールを追加します。

  • Grunt タスクを実行: Grunt タスクを実行するには、このオプションを選択してください。

    表示される Grunt タスク ダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。

    Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。

  • Run gulp task: Gulp タスクを実行するには、このオプションを選択してください。

    表示される Gulp タスク ダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。

    Node.js ランタイムの場所、それに渡すパラメーター、 gulp パッケージへのパスを指定します。

  • npm スクリプトを実行: npm スクリプトを実行するには、このオプションを選択してください。

    開いた NPM スクリプト ダイアログで、 npm 実行 / デバッグ構成設定を指定します。

  • TypeScript をコンパイルする: 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。 表示される TypeScript のコンパイル設定 ダイアログで、 エラーの確認 チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。

    • エラーの確認 チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。

    • エラーの確認 チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。

  • Disconnect Data Source: 実行 / デバッグ構成を実行する前にデータソースへの接続を中断する場合は、このオプションを選択します。

削除ボタン

Alt+Delete

このアイコンをクリックして、選択したタスクをリストから削除します。

編集

Enter

選択したタスクを編集するには、このアイコンをクリックします。 開いたダイアログで必要な変更を加えます。

メソッドアップ

メソッドダウン

Alt+Up

Alt+Down

これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。 タスクは、リストに表示されている順に実行されます。

Show this page

実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。

Activate tool window

デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると 実行または デバッグツールウィンドウが開きます。

それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。 ただし、設定の実行中は、 Alt+4 または Alt+5 を押すことで、対応するツールウィンドウを自分で開くことができます。

ツールウィンドウにフォーカス

実行 / デバッグ構成を開始したときに、 実行または デバッグツールウィンドウに自動的にフォーカスを移動させるには、このチェックボックスを選択してください。

2026 年 6 月 1 日