ハッチ環境を構成する

Hatch(英語) は、Python 用のプロジェクト管理およびパッケージ化ツールです。

Hatch は、setuptools 構成を自動的に移行し、分離された環境を作成し、ビルドを実行して公開できるため、Python パッケージ管理がより効率的になります。

PyCharm のハッチサポート

新しい Python プロジェクトの作成時に Hatch を選択すると、PyCharm は自動的に pyproject.toml ファイルを生成します。このファイルには、必要なパッケージ、スクリプト、プラグイン、URL が指定されています。ファイルの構造と形式の詳細については、pyproject(英語) ガイドを参照してください。

新しく作成されたプロジェクトの構造は次のようになります。

                project_name
                ├── src
                │   └── project_name
                │       ├── __about__.py
                │       └── __init__.py
                ├── tests
                │   └── __init__.py
                ├── LICENSE.txt
                ├── pyproject.toml
                └── README.md
            

既存のプロジェクトを操作する場合、PyCharm は、ローカルマシンまたはリモートソースからインポートされた Hatch プロジェクトも自動的に認識します。

PyCharm で Hatch を使用するには、特定の Python 環境を作成する必要があります。

ハッチ環境を作成する

以下のいずれか 1 つを実行します:
- Python インタープリターセレクターをクリックして、新しいインタープリターを追加を選択します。
- Ctrl+Alt+S を押して設定を開き、Python | インタープリターに移動します。
- Python インタープリターセレクターをクリックしてインタープリターの設定を選択します。利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックします。
利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックし、ローカルインタープリターを追加するを選択します。
次のアクションは、新しい仮想環境を生成するか、既存の仮想環境を使用するかによって異なります。
新しいハッチ環境
1. 環境タイプのリストからハッチを選択します。
2. PyCharm はハッチのインストールを検出します。
  PyCharm がインストールを自動的に検出しなかった場合は、Hatch 実行可能ファイルの場所を指定するか、をクリックして参照します。
3. 環境を選択します。
  Hatch 環境は、プロジェクト固有の様々なタスク用に設計されたワークスペースです。環境が明示的に選択されていない場合、Hatch はデフォルトの環境(英語)を使用します。
4. リストから基本インタープリターを選択するか、をクリックしてファイルシステム内の Python 実行可能ファイルを見つけます。
既存の Hatch 環境
1. 環境タイプのリストからハッチを選択します。
2. PyCharm はハッチのインストールを検出します。
  PyCharm がインストールを自動的に検出しなかった場合は、Hatch 実行可能ファイルの場所を指定するか、をクリックして参照します。
3. リストから環境を選択します。
タスクを完了するには、OK をクリックします。

Hatch モノレポのサポート

PyCharm は Hatch モノレポ構成をサポートしています。ワークスペースモードが有効になっている場合、PyCharm はサブディレクトリ内の pyproject.toml ファイルを検索することでサブプロジェクトを検出します。

サブプロジェクトで .py または pyproject.toml ファイルが開かれると、PyCharm はシステム上にこのプロジェクトの環境がすでに存在するかどうかを確認します。存在する場合は、その環境は自動的に SDK として構成されます。存在しない場合は、ファイルレベルの通知で、このサブプロジェクト用に新しい環境を作成し、依存関係をインストールするように促されます。

詳細は、ワークスペースとモノレポを参照してください。

構成された Python インタープリター (ただし Docker ベース) のいずれかに対して、次の操作を実行できます。

2026 年 4 月 20 日

関連ページ：

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

純粋な Python プロジェクトは、Python プログラミングを対象としています。プロジェクトは、ソースコード、テスト、使用するライブラリ、個人設定を 1 つのユニットに整理できます。プロジェクトが不要な場合は、LightEdit モードでファイルを編集するか、プロジェクトを設定せずに Python ファイルを作成できます。プロジェクトを作成するには、次のいずれかを実行します。に移動します。ウェルカム画面で、新規プロジェクトをクリックします。、新規プロジェクトダイアログで、プロジェクトの場所...

pyproject.toml を使用する

プロジェクトの依存関係は、プロジェクトディレクトリ内の pyproject.toml ファイルで指定できます。pyproject.toml を手動で作成することも、自動的に作成されるように Poetry 環境を構成することもできます。PyCharm は、パッケージ名用のコード補完と、不足している依存関係をインストールするためのクイックフィックスを提供します。プロジェクトの依存関係を指定するエディターで pyproject.toml を開きます。セクションを検索または作成します。必要なパッケージの名前を配列内...

Python インタープリターを構成する

PyCharm の Python インタープリター：Python コードを PyCharm で動作させるには、少なくとも 1 つの Python インタープリターを設定する必要があります。Python インストールで利用可能なシステムインタープリターを使用できます。また、Virtualenv、pipenv、Poetry、uv、hatch、または conda の仮想環境を作成することもできます。仮想環境は、ベースインタープリターとインストールされたパッケージで構成されます。PyCharm Pro で...

ワークスペースとモノレポ

大規模なプロジェクトは、バックエンド、API、共有コードなどの小さな部分に分割することで、整理やメンテナンスが容易になります。PyCharm は、uv ワークスペースやパスベースの依存関係（uv、Poetry、Hatch）など、このようなマルチプロジェクト構成（Python）での作業をサポートしています。ワークスペースモードが有効になっている場合、pyproject.toml を含むディレクトリは Python の管理対象プロジェクトになります。PyCharm はワークスペースのメンバーとサブプロ...

インタープリターのパスを管理する

PyCharm は、選択されたインタープリターにパスを追加することを可能にします。これらのパスは環境変数に追加されます。また、PyCharm はこれらのパスのインデックスを作成し、コードのオブジェクト（たとえば、パッケージのインポート）を（潜在的に）解決します。インタープリターのパスを表示以下のいずれか 1 つを実行します: を押して設定を開き、を選択します。Python インタープリターセレクターをクリックして、インタープリターの設定を選択します。、利用可能なインタープリターのリストを展開し、す...

パッケージのインストール、アンインストール、アップグレード

PyCharm は、特定の Python インタープリター用の Python パッケージをインストール、アンインストール、アップグレードする方法を提供します。これは、各プロジェクトに独自のパッケージセットがあることを意味し、これは Python 依存関係管理のベストプラクティスと見なされます。デフォルトでは、PyCharm はプロジェクトパッケージの管理に pip を使用します。conda 環境では、conda パッケージマネージャーを使用できます。PyCharm では、Python パッケージツー...