PyCharm 2026.1 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 の場合は ファイル | 設定 、macOS の場合は Linux または PyCharm | 環境設定 を選択して 設定 を開き、 Project ノードを展開して プロジェクト構造 を選択します。

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

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

  2. プロジェクト構造ページプロジェクトペイン で、コンテンツルートを設定するプロジェクトをクリックします。

  3. プロジェクト構造ページコンテンツルート で、 コンテンツルートの追加 ボタン コンテンツルートの追加 をクリックします。

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

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

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

  2. プロジェクト構造ページプロジェクトペイン で、コンテンツルートを設定するプロジェクトをクリックします。

  3. プロジェクト構造ページコンテンツルート ペインで、削除するコンテンツルートを選択します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2026 年 6 月 1 日