# パイテスト

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

作成:  `実行 | 構成の編集 |`  ![新規構成の追加](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  `| Python テスト | pytest`

> **Note:**
> [pytest-cov(英語)](https://pypi.org/project/pytest-cov/) プラグインを使用すると、デバッガーに干渉する可能性があります。 これを回避するには、ダイアログの   追加引数   フィールドに  `--no-cov -s`  を追加してください。

このダイアログを使用して、 [pytest(英語)](http://pytest.org) の実行 / デバッグ構成を作成します。

## ツールバー

実行 / デバッグ構成のツリービューには、プロジェクト で利用できる構成の管理や、デフォルト構成テンプレートの調整に役立つツールバーがあります。

|  項目  |  ショートカット  |  説明  |
| --- | --- | --- |
|  ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)  |  `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS))  |  実行 / デバッグ構成を作成します。  |
|  ![削除ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)  |  `Alt+Delete` (Windows), `⌘ ⌦` (macOS), `⌘ ⌦` (IntelliJ IDEA Classic (macOS)), `⌘ ⌦` (macOS System Shortcuts), `Alt+Delete` (XWin), `Alt+Delete` (GNOME), `Alt+Delete` (KDE), `Alt+Delete` (Emacs), `Alt+Delete` (Sublime Text), `⌘ ⌦` (Sublime Text (macOS)), `⌘ ⌦` (Xcode), `Ctrl+R, D` (Visual Studio), `⌘ R, D` (Visual Studio (macOS)), `Alt+Delete` (ReSharper), `⌥ ⌦` (ReSharper (macOS)), `Alt+Delete` (QtCreator), `⌘ ⌦` (QtCreator (macOS)), `Alt+Delete` (NetBeans), `Alt+Delete` (Eclipse), `Alt+Delete` (Eclipse (macOS))  |  選択した実行 / デバッグ構成を削除します。 デフォルト設定は削除できません。  |
|  ![コピー](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.copy.svg)  |  `Ctrl+D` (Windows), `⌘ D` (macOS), `⌘ D` (IntelliJ IDEA Classic (macOS)), `⌘ D` (macOS System Shortcuts), `Ctrl+D` (XWin), `Ctrl+D` (GNOME), `Ctrl+D` (KDE), `Meta+D` (Emacs), `Ctrl+Shift+D` (Sublime Text), `⌘ ⇧ D` (Sublime Text (macOS)), `⌘ D` (Xcode), `Ctrl+D` (Visual Studio), `⌘ D` (Visual Studio (macOS)), `Ctrl+D` (ReSharper), `⌘ D` (ReSharper (macOS)), `Ctrl+D` (QtCreator), `⌘ D` (QtCreator (macOS)), `Ctrl+D` (NetBeans), `Ctrl+D` (Eclipse), `Ctrl+D` (Eclipse (macOS))  |  選択した実行 / デバッグ構成のコピーを作成します。 デフォルト設定のコピーを作成してください。  |
|  ![構成の保存](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.save.svg)  |  |  このボタンは、 [一時的な構成](null)を選択した場合にのみ表示されます。 このボタンをクリックして、一時的な構成を永続的なものとして保存します。  |
|  ![新しいフォルダーに移動する / 新しいフォルダーを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.actions.newFolder.svg)  |  |     新しいフォルダーに移動 / 新しいフォルダーを作成します。 実行 / デバッグ構成は、 [フォルダーに配置](run-debug-configuration.html#config-folders)することでグループ化できます。       フォルダーを作成するには、カテゴリ内の設定を選択し、 ![フォルダー](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.nodes.folder.svg) をクリックしてフォルダー名を指定します。 カテゴリだけにフォーカスがある場合は、空のフォルダーが作成されます。       次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは ![上へ移動](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveUp.svg) ボタンと ![下へ移動](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) ボタンを使用します。       グループ化を解除するには、フォルダーを選択して ![構成を削除](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg) をクリックします。     |
|  ![構成を並べ替え](https://resources.jetbrains.com/help/img/idea/2026.3/workspace.xml` に保存します。     |

## Pytest 固有の設定オプション

|  項目  |  説明  |
| --- | --- |
|  Python インタープリター  |  事前構成された [Python インタープリター](configuring-available-python-interpreters.html)のいずれかを選択します。  |
|  ターゲット: script/module/custom  |     ドロップダウンからターゲットを選択します:        * スクリプト : Python ファイルへのパス。    * モジュール : Python モジュール名とテストクラスインスタンス。    * カスタム : パス、モジュール、テストクラスインスタンスの任意の組み合わせ。      選択したターゲットタイプに応じて、次の値を指定できます。        * テストファイルへのパス（例: `/Users/jetbrains/Car/my_tests/test_car.py` ）。 パスを入力するか、 ![閲覧](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.menu-open.svg) ボタンをクリックしてプロジェクト構造内のファイルを探します。    * プロジェクト内のモジュールの名前です（例: `my_tests` ）。 モジュール名を入力したり、ターゲットモジュールを名前で検索したり、プロジェクト構造内で検索したりすることができます。    * モジュール、スクリプト、クラス、メソッドのカスタム組み合わせ。例えば、 `my_tests.test_car.TestCar.test_brake` のように、： * `my_tests` : パッケージ名 * `test_car` : モジュール名 * `TestCar` : `test_car` のクラスインスタンス * `test_brake` : `TestCar` クラスのメソッド    |
|  追加引数  |     このテキストフィールドには、テストにそのまま渡すフレームワーク固有の追加引数を指定します。例えば：       ``` --some-argument=some-value  ```     > **Warning:** > このオプションは推奨されておらず、CLion でサポートされていないものを起動したい上級者だけが使用してください。    |
|  キーワード  |  テスト名に一致する式。 [docs.pytest.org(英語)](https://docs.pytest.org/en/latest/example/markers.html#using-k-expr-to-select-tests-based-on-their-name) の例を参照してください。  |
|  環境変数  |  参照ボタンをクリックするか、 `Shift+Enter` (Windows), `⇧ ⏎` (macOS), `⇧ ⏎` (IntelliJ IDEA Classic (macOS)), `⇧ ⏎` (macOS System Shortcuts), `Shift+Enter` (XWin), `Shift+Enter` (GNOME), `Shift+Enter` (KDE), `Shift+Enter` (Emacs), `Ctrl+Enter` (Sublime Text), `⌘ ⏎` (Sublime Text (macOS)), `⇧ ⏎` (Xcode), `Shift+Enter` (Visual Studio), `⇧ ⏎` (Visual Studio (macOS)), `Shift+Enter` (ReSharper), `⇧ ⏎` (ReSharper (macOS)), `Shift+Enter` (QtCreator), `⌘ ⏎` (QtCreator (macOS)), `Shift+Enter` (NetBeans), `Shift+Enter` (Eclipse), `⇧ ⏎` (Eclipse (macOS)) を押して、「環境変数」ダイアログで目的の環境変数のセットを指定します。 新しい変数を作成するには、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして希望の名前と値を入力します。  |
|   Docker コンテナーの設定    > **Warning:** > このフィールドは、プロジェクトに [Docker ベースのリモートインタープリター](docker.html)が選択されている場合にのみ表示されます。     > **Note:** > 設定といくつかのオプション（  `--net`  、  `--link`  など）との対応について言えば、これらのオプションは [Docker コマンドライン引数(英語)](https://docs.docker.com/engine/reference/commandline/run/)からのものであることに注意してください。      ![参照ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) をクリックしてダイアログを開き、以下の設定を指定します。     |
|  オプション  |      * ネットワークを無効にする ：ネットワークを無効にするには、このチェックボックスを選択してください。 これは `--net="none"` に対応し、コンテナ内では外部ネットワークリソースが利用できないことを意味します。    * ネットワークモード : オプション `--net` の他の値に対応します。 * `bridge` がデフォルト値です。 ブリッジのネットワーク上のコンテナーに IP アドレスが割り当てられ、トラフィックはこのブリッジを介してコンテナーにルーティングされます。 コンテナーは、デフォルトで IP アドレスを介して通信できます。 名前で通信するには、リンクする必要があります。 * `host` : コンテナー内のホストのネットワークスタックを使用します。 * `container:<name\|id>` : 名前 または ID で指定された別のコンテナーのネットワークスタックを使用してください。 詳細については、 [ネットワーク設定(英語)](https://docs.docker.com/engine/reference/run/#network-settings)のドキュメントを参照してください。    * リンク : このセクションを使用して、作成するコンテナーを他のコンテナーとリンクします。 これは `Network mode = bridge` に適用され、 `--link` オプションに対応します。    * すべてのポートを公開する : すべてのコンテナーポートをホストに公開します。 これはオプション `--publish-all` に対応します。    * ポートバインディング ： [ポートバインディング](https://docs.docker.com/engine/reference/run/#expose-incoming-ports)のリストを指定します。 `docker run` で `-p` オプションを使用するのと同じです。    * 追加ホスト : `--add-host` オプションに対応します。 詳細については、「 [/etc/hosts の管理(英語)](https://docs.docker.com/engine/reference/run/#managing-etc-hosts)」を参照してください。    * ボリュームバインディング : このフィールドを使用して、特別なフォルダー ( ボリューム) と、Docker デーモンが実行されるコンピューターのフォルダー間のバインドを指定します。 `-v` オプションに対応します。 詳細については、「 [コンテナー内のデータを管理する(英語)](https://docs.docker.com/userguide/dockervolumes/)」を参照してください。    * 環境変数 : このフィールドを使用して、環境変数とその値のリストを指定します。 これは `-e` オプションに対応します。 詳細については、「 [ENV (環境変数)(英語)](https://docs.docker.com/engine/reference/run/#env-environment-variables)」を参照してください。      ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moveDown.svg) をクリックしてテーブルを展開します。 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.remove.svg)、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.edit.svg) をクリックしてリストを作成します。     |

## 追加オプション

オプションを変更   をクリックし、ダイアログに追加したいオプションを選択してください。

### オペレーティングシステム

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

### Python

|  項目  |  説明  |
| --- | --- |
|  インタープリターオプション  |  このフィールドで、インタープリターに渡される [コマンドラインオプション(英語)](https://docs.python.org/3/using/cmdline.html#command-line)を指定します。 必要に応じて、 ![Expand the field](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.expandComponent.svg) をクリックし、エディターに文字列を入力します。  |
|  PYTHONPATH にコンテンツルートを追加する  |  プロジェクト内のすべての [コンテンツルート](null)を環境変数 PYTHONPATH に追加するには、このチェックボックスを選択してください。  |
|  PYTHONPATH にソースルートを追加する  |  プロジェクトのすべての [ソースルート](null)を環境変数 PYTHONPATH に追加するには、このチェックボックスを選択してください。  |

### デバッグ

|  項目  |  説明  |
| --- | --- |
|  自分のコードのみデバッグする  |  このオプションを有効にすると、デバッガーはユーザーが記述したコードのみに焦点を当て、外部ライブラリへのステップインをスキップします。  |

### ログ

次のオプションは、この構成の実行のログ記録に関連しています。 詳細については、 [](null)を参照してください。

|  項目  |  説明  |
| --- | --- |
|     コンソールに表示するログを指定する。     |     アプリケーション実行中に表示するログファイルを指定します。       ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいログを追加します。   ログファイルエイリアスの編集   ダイアログで、次のように構成します。        * エイリアス : ログが表示されるタブの名前。    * ログファイルのロケーション : ログファイルまたは [Ant パターン(英語)](https://ant.apache.org/manual/dirtasks.html)へのパスを指定します。 ローリングログの複数ファイルがパターンに一致する場合、CLion は最も新しいものを表示します。    * パターンでカバーできるすべてのファイルを表示する。 : パターンに一致するすべてのログを表示します。      テーブル内のログに対して、次のオプションを構成できます：        * アクティブ : 指定したログファイルを表示します。    * 内容のスキップ​​​ : 以前の実行からの古いログメッセージを表示しません。    |
|     コンソール出力をファイルに保存する     |  コンソール出力を指定の場所に保存します。 パスを手動で入力するか、参照ボタンをクリックして [表示されるダイアログ](select-path-dialog.html)で目的の場所を指定します。  |
|     メッセージが標準出力に出力されたときにコンソールを表示する     |  アプリケーションが標準出力ストリームに書き込む際にコンソールを有効化します。  |
|     メッセージが標準エラーに出力されたときにコンソールを表示する     |  アプリケーションが標準エラーストリームに書き込む際にコンソールを有効化します。  |

### 起動前

|  項目  |  説明  |
| --- | --- |
|     開始時に実行 / デバッグツールウィンドウを開く     |     デフォルトではこのオプションが選択されており、実行 / デバッグ構成を開始すると、 [実行](run-tool-window.html)または [デバッグ](debug-tool-window.html)ツールウィンドウが開きます。       そうでない場合、ツールウィンドウは非表示になります。 ただし、設定の実行中は、 `Alt+4` (Windows), `⌘ 4` (macOS), `⌘ 4` (IntelliJ IDEA Classic (macOS)), `⌘ 4` (macOS System Shortcuts), `Alt+4` (XWin), `Alt+4` (GNOME), `Alt+4` (KDE), `Alt+4` (Emacs), `Alt+4` (Sublime Text), `⌘ 4` (Sublime Text (macOS)), `⌘ 6` (Xcode), `Alt+4` (Visual Studio), `⌘ 4` (Visual Studio (macOS)), `Alt+4` (ReSharper), `⌘ 4` (ReSharper (macOS)), `Alt+3` (QtCreator), `⌘ 3` (QtCreator (macOS)), `Alt+4` (NetBeans), `Alt+4` (Eclipse), `⌘ 4` (Eclipse (macOS)) または `Alt+5` (Windows), `⌘ 5` (macOS), `⌘ 5` (IntelliJ IDEA Classic (macOS)), `⌘ 5` (macOS System Shortcuts), `Alt+5` (XWin), `Alt+5` (GNOME), `Alt+5` (KDE), `Alt+5` (Emacs), `Alt+5` (Sublime Text), `⌘ 5` (Sublime Text (macOS)), `⌘ 7` (Xcode), `Alt+5` (Visual Studio), `⌘ 5` (Visual Studio (macOS)), `Alt+5` (ReSharper), `⌘ 5` (ReSharper (macOS)), `Alt+5` (QtCreator), `⌘ 5` (QtCreator (macOS)), `Alt+5` (NetBeans), `Alt+5` (Eclipse), `⌘ 5` (Eclipse (macOS)) を押すことで、対応するツールウィンドウを自分で開くことができます。     |
|     開始時に 実行/デバッグ ツールウィンドウにフォーカスする     |     このオプションを選択すると、実行 / デバッグ構成を開始したときに、 [実行](run-tool-window.html)または [デバッグ](debug-tool-window.html)ツールウィンドウに自動的にフォーカスが移動します。     |
|     開始前に実行 / デバッグ構成を表示する     |     このオプションを選択すると、実行／デバッグ構成を実際に開始する前に、実行／デバッグ構成の設定が表示されます。     |
|     起動前タスクの追加​     |     このオプションを選択すると、以下の利用可能なタスクのいずれかを追加できます。        * 外部ツールの実行 : 外部アプリケーションを実行することを選択します。 開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 CLion でまだ定義されていない場合は、定義を追加してください。 詳細については、 [外部ツール](configuring-third-party-tools.html)および [外部ツール](settings-tools-external-tools.html)を参照してください。    * 別の構成を実行 : 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。 複数の構成を並行して実行する場合は、 [複合実行 / デバッグ構成](run-debug-multiple.html#compound-configs)を使用してください。    * ファイル監視の実行 ：このオプションを選択すると、CLion ですべての現在アクティブな [File Watchers](using-file-watchers.html)が適用されます。    * Grunt タスクの実行 : Grunt タスクを実行するには、このオプションを選択してください。 表示される Grunt タスク ダイアログで、必要なタスクが定義されている `Gruntfile.js` を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。    * gulp タスクの実行 : Gulp タスクを実行するには、このオプションを選択してください。 表示される Gulp タスク ダイアログで、必要なタスクが定義されている `Gulpfile.js` を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 gulp パッケージへのパスを指定します。    * npm スクリプトを実行 : npm スクリプトを実行するには、このオプションを選択してください。 開いた NPM スクリプト ダイアログで、 [npm 実行 / デバッグ構成設定](null)を指定します。    * TypeScript のコンパイル : 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。 表示される TypeScript のコンパイル設定 ダイアログで、 エラーの確認 チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。 * エラーの確認 チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。 * エラーの確認 チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。    * CoffeeScript ソースマップの生成 ：このオプションを選択すると、 [CoffeeScript](coffeescript.html)ソースのソースマップが生成されます。 表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。    |

## See also

### プロシージャ

[実行 / デバッグ構成](run-debug-configuration.html)

### 言語・フレームワーク別ガイドライン

### 外部リンク

[pytest feature overview](http://pytest.org)

