PyCharm 2026.1 ヘルプ

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

PyCharm で行うことは何でも、プロジェクトのコンテキストで行います。プロジェクトは、完全なソフトウェアソリューションを表す組織単位です。これは、コーディング支援、一括リファクタリング、コーディングスタイルの一貫性などの基礎として機能します。

プロジェクトファイル

PyCharm のプロジェクトはディレクトリベースのフォーマットで表現されています。プロジェクトディレクトリに Project directory icon アイコンが表示されます。

このようなプロジェクトディレクトリには、次のファイルを含む .idea ディレクトリが含まれます。

  • プロジェクト構造を記述する .iml ファイル。

  • ワークスペース設定を含む workspace.xml ファイル。

  • 多数の xml ファイル。各 xml ファイルは、projectCodeStyle.xmlencodings.xmlvcs.xml という名前で認識できる、独自の設定セットを担当します。

    たとえば、新しい実行 / デバッグ構成を追加してエンコーディングを変更すると、2 つの異なる xml ファイルに影響します。これにより、プロジェクト設定がバージョン管理システムに格納され、異なるチームメンバーによって変更されたときのマージの競合を回避できます。

ローカル設定を保存する workspace.xml を除いて、.idea ディレクトリ内の設定ファイルはすべてバージョン管理下に置く必要があります。workspace.xml ファイルは、VCS によって無視されるものとしてマークする必要があります。

.idea ディレクトリは、プロジェクトツールウィンドウのプロジェクトビューには表示されません。

プロジェクトタイプ

各プロジェクトのディレクトリ構造には、PyCharm 固有の設定、プロジェクトファイル、およびライブラリ用の .idea ディレクトリが含まれています。

PyCharm は次のタイプのプロジェクトを提案しています:

  • Pure Python プロジェクトは純粋な Python プログラミングを目的としています。このプロジェクトのディレクトリ構造には、PyCharm 固有の設定とプロジェクトファイル、ライブラリを格納する .idea ディレクトリが含まれます。

    Python プロジェクトを作成するセクションに従って、プレーンな Python プロジェクトを作成します。

  • Django プロジェクト。このプロジェクトタイプは、Django(英語) アプリケーションの特定のインフラストラクチャ、およびすべての必要なファイルと設定を提供します。

    Django プロジェクトを作成するセクションの説明に従って、Django アプリケーションを作成します。

    Django アプリケーションを使用するにはデータベースが必要です。SQLite は事前に設定されているため、使用することをお勧めします。別のデータベースエンジンを使用する場合は、正しくインストールおよび設定されていることを確認してください。

  • Flask プロジェクト。このプロジェクトタイプは、Flask アプリケーションの特定のインフラストラクチャ、およびすべての必要なファイルと設定を提供します。

    Flask プロジェクトの作成セクションの説明に従ってプロジェクトを作成します。

PyCharm Edu プロジェクト

  • 教育プロジェクトは、Python を学習したい学生を対象としています。

    教育プロジェクトは、次のエンティティで構成されています。

    このようなプロジェクトを作成するプロセスは、学習者スタートガイド(英語)で説明されています。

  • コースは教育者を対象としています。

    コースは次のエンティティで構成されています。

    コース

    コースは、特別なタイプのプロジェクトにすぎません。レッスンで構成されています。

    レッスン

    レッスンは、タスクファイルが格納されるディレクトリです。各レッスンには複数のタスクを含めることができます。

    タスク

    タスクは、次のファイルが格納されているディレクトリです。

    • タスクの説明ツールウィンドウに入力する必要があるタスクの説明

    • エクステンション .py のファイル。これには演習コードが含まれ、解答プレースホルダーを含めることができます。

    • テストファイル tests.py。これは、生徒があなたの課題を正しく達成したことを確認できます。

    タスクには、それを達成するために必要なファイルがさらに含まれることもあります。

    回答プレースホルダー

    回答プレースホルダーは、初期コードの一部を置き換えて非表示にする、学生に表示されるフレームです。これらのプレースホルダーには、タスクを完了するために学生が実行するアクションの説明を含める必要があります。これらのアクションの説明を自分で作成する必要があります。

    回答プレースホルダ内を最初にマウスクリックすると、プレースホルダ全体が選択されます。2 回目のマウスクリックで選択が解除されます。

    ヒント

    生徒が自分に自信がない場合は、ヒントを表示できます。ヒントも教育者によって作成されます。

    これらのファイル群の他に、PyCharm は講師がテストを書くために使用できる便利な機能を含む特別なファイル test_helper.py を提供します。

    詳細は、教育者スタートガイド(英語)を参照してください。

プロジェクト設定

プロジェクト設定は、現在のプロジェクトにのみ適用されます。それらは、他のプロジェクトファイルと一緒に .xml 形式で .idea ディレクトリに保存されます。例: プロジェクトは、VCS 設定、コードスタイルのスペルチェッカー設定、言語インジェクションのリストなどを保持します。これらの設定は、VCS に送信するときに、アプリケーションコードとともにバージョン管理下に自動的に配置されます。

プロジェクト設定を構成するには、macOS (Ctrl+Alt+S) の場合は PyCharm | 環境設定、Windows および Linux の場合はファイル | 設定を選択します。

設定ダイアログでは、Project configurable アイコンでマークされた設定は現在のプロジェクトにのみ適用されます。その他の設定はグローバルであり、既存のすべてのプロジェクトに適用されます。

Project settings

既存のプロジェクト間でプロジェクト設定を共有したい場合は、設定の同期プラグインを使用できます。設定を ZIP アーカイブにエクスポートし、後で他の IDE インスタンスにインポートすることもできます。

現在のプロジェクトだけでなく、後で作成するすべてのプロジェクトのプロジェクト設定を構成できます。つまり、プロジェクトに新しいデフォルト設定を設定できます。

デフォルトのプロジェクト設定を構成する

メインメニューで、ファイル | 新規プロジェクトのセットアップ | 新規プロジェクトの設定に移動します。

    2026 年 2 月 10 日

    関連ページ:

    バージョン管理統合サポート

    PyCharm は 2 つのレベルでバージョン管理統合をサポートします。IDE レベルでは、VCS 統合は、デフォルトで有効になっているバンドルされたプラグインのセットを通じて提供されます。プロジェクトレベルでは、プロジェクトフォルダーを 1 つまたは複数のバージョン管理システムと関連付けることで、VCS 統合が有効になります。プロジェクトルートをバージョン管理システムに関連付ける:PyCharm を使用すると、プロジェクトとバージョン管理システムの統合を迅速に有効にし、それをプロジェクトルー...

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

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

    プロジェクトツールウィンドウ

    プロジェクトツールウィンドウを使用すると、さまざまな視点からプロジェクトを確認したり、新しいアイテム(ディレクトリ、ファイル、クラスなど)の作成、エディターでのファイルのオープン、必要なコード断片への移動など、さまざまなタスクを実行したりできます。このツールウィンドウのほとんどの機能には、コンテンツペインのコンテキストメニューコマンドとして、関連するショートカットを介してアクセスします。このビューには、作成されたスクラッチファイル、クエリコンソール、拡張スクリプトを管理できるスクラッチとコンソー...

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

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

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

    Django プロジェクトは、Django を使用した生産的な Web 開発を目的としています。PyCharm は、Django アプリケーションに必要な特定のディレクトリ構造とファイルを作成し、正しい設定を提供します。Django プラグインを有効にするこの機能は、デフォルトで PyCharm にバンドルされて有効になっている Django プラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認してください。を押して設定を開き、を選択します。インス...

    Flask プロジェクトの作成

    Flask プロジェクトは、Flask アプリケーションの生産的な開発を目的としています。PyCharm は、特定のディレクトリ構造と設定の作成を処理します。Flask プロジェクトを作成するメインメニューでに移動するか、ウェルカム画面の新規プロジェクトボタンをクリックします。新規プロジェクトダイアログで、次の操作を行います。プロジェクトタイプとして Flask を選択します。プロジェクトの場所を指定します。プロジェクト名は、指定されたパス内のフォルダー名から自動的に取得されます。プロジェクトを Gi...