PyCharm 2026.1 ヘルプ

Poetry 環境を構成する

Poetry(英語) は、プロジェクトの依存関係に基づいて Python 仮想環境を簡単に作成できるツールです。プロジェクトが依存するライブラリを宣言でき、Poetry がインストールして更新します。

プロジェクトの依存関係は、必要なパッケージ、スクリプト、プラグイン、URL を指定する pyproject.toml ファイルに記録されます。ファイルの構造と形式の詳細については、pyproject(英語) リファレンスを参照してください。

PyCharm で Poetry を使用するには、Poetry をマシンにインストールして、特定の Python 環境を作成する必要があります。

Poetry をインストールする

  1. ターミナル (macOS および Linux の場合) または PowerShell (Windows の場合) を開き、次のコマンドを実行します。

    curl -sSL https://install.python-poetry.org | python3 -
    (Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
    curl -sSL https://install.python-poetry.org | python3 -
  2. macOS と Windows では、インストールスクリプトは、詩の実行可能ファイルを含むフォルダーを PATH 変数に追加することを提案します。これを行うには、次のコマンドを実行します。

    export PATH="/Users/jetbrains/.local/bin:$PATH"
    $Env:Path += ";C:\Users\jetbrains\AppData\Roaming\Python\Scripts"; setx PATH "$Env:Path"

    jetbrains を自分のユーザー名に置き換えることを忘れないでください。

  3. インストールを確認するには、次のコマンドを実行します。

    poetry --version

    Poetry (version 1.2.0) のようなものが表示されるはずです。

詳細については、Poetry のインストール手順(英語)を参照してください。

Poetry 環境を作成する

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

    • Python インタープリターセレクターをクリックして、新しいインタープリターを追加を選択します。

    • Ctrl+Alt+S を押して設定を開き、Python | インタープリターに移動します。

    • Python インタープリターセレクターをクリックしてインタープリターの設定を選択します。利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックします。

  2. 利用可能なインタープリターのリストの横にあるインタープリターの追加リンクをクリックし、ローカルインタープリターを追加するを選択します。

  3. 次のアクションは、新しい Poetry 環境を作成するか、既存の環境を使用するかによって異なります。

    新しい Poetry 環境
    Generate new poetry environment
    1. 環境タイプのリストから Poetry を選択します。

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

    3. PyCharm は Poetry のインストールを検出します。

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

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

    既存の Poetry 環境
    Select existing poetry environment
    1. 環境タイプのリストから Poetry を選択します。

    2. PyCharm は Poetry のインストールを検出します。

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

    3. リストから環境を選択します。

    選択した Poetry 環境は、現在のプロジェクトで再利用されます。

  4. タスクを完了するには、OK をクリックします。

新しい Python プロジェクトを作成するときに Poetry 環境を選択すると、PyCharm はプロジェクト要件を備えた pyproject.toml を作成します。

pyproject.toml ファイルを変更するたびに、PyCharm は通知し、poetry.lock ファイルの変更を記録する ( 詩のロック )、または変更を記録して満たされていない要件をインストールする ( 詩の更新 ) という 2 つのアクションを提案します。

Lock or update poetry

pyproject.toml を使用して Poetry 環境を作成する

  1. pyproject.toml を含むプロジェクトを開いたが、プロジェクトインタープリターが構成されていない場合、PyCharm は Poetry 環境を設定することを提案します。

    pyproject.toml detected
  2. PyCharm は Poetry 実行可能ファイルへのパスを表示します。OK をクリックしてパスを確認します。

  3. PyCharm が Poetry 実行可能ファイルを自動検出できない場合は、そのパスを手動で指定します。

新しい Poetry 環境がプロジェクト用に構成され、pyproject.toml にリストされているパッケージがインストールされます。

Poetry モノレポのサポート

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

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

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

2026 年 4 月 20 日

関連ページ:

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 で...

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

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

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

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

Pipenv 環境を構成する

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

conda 仮想環境を構成する

PyCharm は、conda を使用して Python 用の仮想環境を作成することをサポートしています。以下の手順は、サポートされているすべてのオペレーティングシステムに適用されます。このページ上部のプラットフォーム切り替えツールを使用して、お使いのオペレーティングシステム固有のショートカットを表示してください。conda 環境を作成する Anaconda または Miniconda がコンピューターにダウンロードされインストールされていること、およびその実行可能ファイルへのパスを認識していることを確認...