PyCharm 2025.2 ヘルプ

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

純粋な Python プロジェクトは、 Python プログラミングを対象としています。プロジェクトは、ソースコード、テスト、使用するライブラリ、個人設定を 1 つのユニットに整理できます。

プロジェクトが不要な場合は、LightEdit モードでファイルを編集するか、プロジェクトを設定せずに Python ファイルを作成できます。

  1. プロジェクトを作成するには、次のいずれかを実行します。

    • ファイル | 新規プロジェクトに移動します。

    • ウェルカム画面で、新規プロジェクトをクリックします。

  2. 新規プロジェクトダイアログで、プロジェクトの場所を指定します。プロジェクト名は、指定されたパスのフォルダー名から自動的に派生されます。

    Creating a new project
    Creating a Python project
  3. プロジェクトを Git バージョン管理下に置くには、Git リポジトリの作成を選択します。

    PyCharm で main.py ファイルをプロジェクトに追加する場合は、main.py ウェルカムスクリプトを作成するを選択します。このファイルには単純な Python コードサンプルが含まれており、プロジェクトの開始点として使用できます。

    Welcome script in the Python project
  4. プロジェクトの venv またはベース conda インタープリターを続行する場合は、対応するオプションを選択して、作成をクリックします。

    プロジェクトの venv

    PyCharm は、プロジェクトフォルダー内にシステム Python に基づいて virtualenv 環境を作成します。

    ベース conda

    PyCharm は、conda ベース環境をプロジェクトインタープリターとして構成します。

    別のタイプのインタープリターを構成するか、既存の環境を使用する場合は、カスタム環境を選択します。

    次の手順は、選択内容によって異なります。

    Create a project with a conda environment
    • 環境タイプのリストから Conda を選択します。

    • リストから Python のバージョンを選択します。

    • 環境名を指定します。

    • PyCharm は conda のインストールを検出します。

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

    Create a project with virtualenv
    • 環境タイプのリストから Virtualenv を選択します。

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

    • ロケーションフィールドに新しい仮想環境の場所を指定するか、Virtual environment location をクリックしてファイルシステム内の場所を参照します。新しい仮想環境のディレクトリは空である必要があります。

    • マシン上のグローバル Python にインストールされているすべてのパッケージを、これから作成する仮想環境に追加する場合は、ベースインタープリターからパッケージを継承するチェックボックスを選択します。このチェックボックスは、virtualenv(英語) ツールの --system-site-packages オプションに対応しています。

    • PyCharm で Python インタープリターを作成するときにこの環境を再利用する場合は、すべてのプロジェクトで使用可能にするチェックボックスを選択します。

    Create a project with Pipenv
    • 環境タイプのリストから Pipenv を選択します。

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

    • ベースバイナリディレクトリを PATH 環境変数に追加した場合、追加のオプションを設定する必要はありません。pipenv 実行可能ファイルへのパスは自動検出されます。

      PyCharm が pipenv 実行可能ファイルを検出しない場合は、pip 経由で pipenv をインストールするをクリックして、PyCharm が自動的にインストールできるようにします。

      または、pipenv のインストール手順に従って実行可能パスを検出し、それをダイアログで指定します。

    Create a project with Poetry
    • 環境タイプのリストから Poetry を選択します。

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

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

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

    • プロジェクトディレクトリ内に仮想環境を作成するには、プロジェクト内環境を作成するチェックボックスを選択します。

    Create a project with uv
    • 環境タイプのリストから uv を選択します。

    • リストから Python のバージョンを選択します。

    • 通常、PyCharm は uv のインストールを検出します。

      それ以外の場合は、uv 実行可能ファイルの場所を指定するか、uv executable location をクリックして参照します。

    Create a project with Hatch
    • 環境タイプのリストからハッチを選択します。

    • 通常、PyCharm はハッチのインストールを検出します。

      それ以外の場合は、Hatch 実行可能ファイルの場所を指定するか、uv executable location をクリックして参照します。

    • 環境を選択します。

      Hatch 環境は、プロジェクト固有の様々なタスク用に設計されたワークスペースです。環境が明示的に選択されていない場合、Hatch はデフォルトの環境(英語)を使用します。

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

    Selecting an existing conda interpreter for a new project

    既存の conda 環境を再利用するには:

    • タイプConda に切り替えます。

    • 環境名を指定します。

    • PyCharm は conda のインストールを検出します。

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

    • リストから環境を選択します。conda へのパスを手動で指定した場合は、環境を再ロードする必要がある場合があります。

    Selecting an existing interpreter for a new project

    Virtualenv、Pipenv、Poetry 環境を再利用するには:

    • タイプPython に切り替えます。

    • リストから Python 実行可能ファイルを選択するか、 をクリックして参照します。

プロジェクトを作成したら、プロジェクト構造の構成に進むことができます。

2025 年 6 月 25 日

関連ページ:

PyCharm でプロジェクトを構成する

PyCharm で行うことは何でも、プロジェクトのコンテキストで行います。プロジェクトは、完全なソフトウェアソリューションを表す組織単位です。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性などの基礎として機能します。プロジェクトファイル:PyCharm のプロジェクトはディレクトリベースのフォーマットで表現されています。プロジェクトディレクトリにアイコンが表示されます。このようなプロジェクトディレクトリには、次のファイルを含む .idea ディレクトリが含まれます。プ...

LightEdit モード

PyCharm でプロジェクト全体を作成またはロードせずに 1 つのファイルを編集する必要がある場合は、LightEdit モードを使用できます。LightEdit モードはテキストのようなエディターとして動作し、コード補完やコードナビゲーションなどの通常の IDE エディター機能はサポートされていないことに注意してください。ただし、特定のコード行 () に移動したり、コードの一部を折りたたんだり展開したり、ファイルのエンコーディングを確認したり変更したり、コードを再フォーマットしたりすることはで...

クイックスタートガイド

PyCharm は、Python 開発者に幅広い必須ツールを提供する専用の Python 統合開発環境(IDE)であり、緊密に統合されて、生産的な Python、Web、およびデータサイエンス開発のための便利な環境を作成します。PyCharm の機能について詳しく見る:以前は、PyCharm は Community と Professional の 2 つのエディションで提供されていました。PyCharm 2025.1 から、PyCharm Community と Professional は統...

ウェルカム画面

PyCharm は、プロジェクトが開かれていないときにウェルカム画面を表示します。例: PyCharm を初めて実行するとき、またはプロジェクトの唯一の開いているインスタンスを閉じるとき。この画面から、新しいプロジェクトを作成したり、教育向け PyCharm でパスの学習を開始したり、インポートしたり、開いたり、バージョン管理から既存のプロジェクトをチェックアウトしたりできます。カスタマイズタブを使用して作業環境を構成し、プラグインタブを使用して IDE プラグインを管理します。学習タブを開いて、I...

Git リポジトリのセットアップ

既存の Git リポジトリのクローンを作成するか、既存のプロジェクトを Git バージョンコントロール下に置くと、PyCharm はコンピューターに Git がインストールされているかどうかを自動的に検出します。IDE が Git 実行可能ファイルを見つけられない場合、それをダウンロードすることを提案します。PyCharm は、Windows10 バージョン 2004 で使用可能な Windows Subsystem for Linux 2 (WSL2) の Git をサポートします。Git が...

Pipenv 環境を構成する

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