PyCharm 2026.3 Help

プロジェクト構造の設定

PyCharm では、 コンテンツは現在作業しているファイルのコレクションであり、サブフォルダーの階層に編成されている場合があります。 プロジェクトの最上位フォルダーは、その コンテンツルートです。

コンテンツルート内で、PyCharm はソースコードを含むフォルダーと、検索、解析、ウォッチなどの際に無視するフォルダーを区別できます。 異なる種類のフォルダーを区別するには、コンテンツルートのフォルダーをソースフォルダーまたは除外フォルダーとしてマークします。

  • ソースルート the Source root icon には、実際のソースファイルとリソースが含まれています。 PyCharm はソースルートをインポート解決の開始点として使用します。

  • 除外ルート 除外されたルートアイコン には、プロジェクトの分析、検索、解析、ウォッチなどの際にPyCharm によって無視されるファイルとフォルダーが含まれています。

  • テストソースルート テストルートアイコン これらのフォルダーは、テストに関連するコードを実動コードとは別に保持します。 コードソースとテストソースは通常、異なるフォルダーに配置されます。

  • リソースルート the Resources root icon (PyCharm Pro のみ)は、アプリケーション内のリソースファイル(イメージ、スタイルシートなど)を対象としています。 このカテゴリにフォルダーを割り当てることで、そのフォルダーおよびサブフォルダー内のファイルは、フルパスを指定する代わりに、そのフォルダーを基準にして参照できることをPyCharm に知らせます。

  • 名前空間パッケージ パッケージ 名前空間パッケージ(英語)を使用すると、単一のパッケージ内にサブパッケージとモジュールを作成できます。 任意のディレクトリを名前空間パッケージとしてマークして、そのディレクトリ内のインポートステートメントを解決できます。

  • テンプレートルート the Template Folder icon (PyCharm Pro のみ)には、さまざまな Web プロジェクトのテンプレートが含まれています。

プロジェクト構造にアクセスするには、 Ctrl+Alt+S を押すか、Windows と Linux では ファイル | 設定 、macOS では %instance% | 設定 を選択して 設定 を開き、 プロジェクト構造 を選択します。 このページの ソース​​ア タブでコンテンツルートを構成できます。

コンテンツルートを作成する

  1. プロジェクト構造を開くの設定。

  2. プロジェクトに複数のサブプロジェクトが含まれている場合は、左側のリストで構成するサブプロジェクトを選択します。 次に、 ソース​​ア タブを開きます。

  3. ソース​​ア タブで、 コンテンツルートの追加 ボタン コンテンツルートの追加 をクリックします。

  4. 開いたダイアログで、必要なディレクトリを見つけて、 OK をクリックします。

コンテンツルートを取り外す

  1. プロジェクト構造を開くの設定。

  2. プロジェクトに複数のサブプロジェクトが含まれている場合は、左側のリストで構成するサブプロジェクトを選択します。 次に、 ソース​​ア タブを開きます。

  3. ソース​​ア タブで、削除するコンテンツルートを選択します。

  4. 削除 ボタン コンテンツルートの除去 をクリックし、取り外しを確認します。

フォルダーを別のカテゴリに割り当てることができます。 これは、 プロジェクト ツールウィンドウと設定ダイアログの プロジェクト構造ページの両方で実行できます。

プロジェクトツールウィンドウでフォルダーにカテゴリを割り当てる

  1. プロジェクト ツールウィンドウ (たとえば、 表示 | ツールウィンドウ | プロジェクト) を開きます。

  2. 特定のカテゴリに割り当てるフォルダーを選択します。

  3. 右クリックして、 ディレクトリとしてマーク メニューから必要なカテゴリを選択します。

同様に、後でフォルダーカテゴリを変更することもできます。 (コンテキストメニューから別のカテゴリを選択するだけです。)

フォルダーと現在のカテゴリとの関連付けを解除するには(つまり、フォルダーを「通常の」フォルダー フォルダー にするには)、 <current_category> としてマークを解除する を選択してください。 (例: リソースルートのマーク解除)。

プロジェクト設定でフォルダーにカテゴリを割り当てる

  1. 設定ダイアログの プロジェクト構造ページ (Ctrl+Alt+S )を開きます。

  2. プロジェクトに複数のサブプロジェクトが含まれている場合は、左側のリストで構成するサブプロジェクトを選択します。 次に、 ソース​​ア タブを開きます。

  3. カテゴリを割り当てるフォルダーを選択します。

  4. カテゴリアイコン (例: the Source root icon) をクリックします。

名前パターンを指定することで、ファイルやフォルダーを 除外できます。 ファイルを除外する フィールドを使用してパターンを指定します。

名前が指定されたパターンの少なくとも 1 つと一致するファイルとフォルダーは除外されます。 フォルダーはすべてのコンテンツと共に除外されます。

2026 年 10 月 30 日