PyCharm 2026.1 Help

プロジェクトの作成と管理

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

PyCharm でフォルダーを開くと、 .idea サブフォルダーが追加され、PyCharm の内部構成設定(例:プロジェクトのコードスタイルやバージョン管理システム)がそこに保存されます。

PyCharm はリモートホスト上のファイルの直接編集をサポートしていません。 そのため、PyCharm でリモートソースを操作するには、 既存のソースからプロジェクトを作成する に記載されているとおり、それらをダウンロードし、保存されているフォルダーを開いて、PyCharm プロジェクトに配置する必要があります。 ローカルソースとリモートソースの同期を維持するには、 デプロイオプションダイアログの 変更されたファイルをデフォルトサーバーに自動アップロードする リストを使用して自動アップロードを構成します。

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

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

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

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

  • 多数の xml ファイル。 各 xml ファイルは、 projectCodeStyle.xml encodings.xml vcs.xml などの名前で認識できる独自の設定セットを担当します。

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

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

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

2026 年 6 月 1 日