PyCharm 2025.3 ヘルプ

プロジェクト構造の設定

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

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

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

  • 除外ルートthe Excluded root icon には、プロジェクトの分析、検索、解析、監視など中に PyCharm によって無視されるファイルとフォルダーが含まれています。

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

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

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

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

プロジェクト構造にアクセスするには、Ctrl+Alt+S を押すか、Windows の場合はファイル | 設定、macOS の場合は Linux または PyCharm | 環境設定を選択して設定を開き、プロジェクトノードを展開してプロジェクト構造を選択します。

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

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

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

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

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

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

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

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

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

  4. 除去ボタン Remove content root をクリックし、取り外しを確認します。

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

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

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

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

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

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

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

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

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

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

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

Assign a category to a folder in the project settings

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

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

2026 年 1 月 14 日

関連ページ:

コンテンツルート

PyCharm では、コンテンツは現在作業しているファイルの集まりであり、おそらくサブフォルダーの階層に編成されています。この階層の最上位にあるフォルダーは、コンテンツルートフォルダーまたはコンテンツルート (と表示) と呼ばれます。プロジェクトには少なくとも 1 つのコンテンツルートフォルダーがあり、既定ではプロジェクトフォルダー自体です。いくつかのコンテンツルートを持つことで、共通の直系親を持たない複数のディレクトリからのファイルを扱うことができます。これは、静的コンテンツ(アイコンなど)を使...

プロジェクトを作成する

プロジェクトを作成したら、新しい項目の追加(新しいディレクトリ、パッケージ、ファイルの作成、既存のファイルとフォルダーの追加)を開始できます。新規項目の作成:任意の拡張子を持つ以下のいずれか 1 つを実行します: プロジェクトツールウィンドウ () で、新しいファイルを作成するディレクトリまたはパッケージを選択し、メインメニューからを選択します。ディレクトリまたはパッケージを右クリックし、コンテキストメニューから新規を選択します。ディレクトリを選択し、を押します。、必要なファイルタイプを選択し...

設定

このダイアログを使用して、PyCharm 設定(グローバルとプロジェクト固有のものの両方)を変更します。ダイアログの左上部分にある検索フィールドを使用して、目的のオプションを見つけます。あるいは、検索フィールドにあるカテゴリ (設定のグループ) の階層リストを使用して設定を参照することもできます。IDE 設定を変更した後、OK をクリックして変更を適用してダイアログを閉じるか、適用をクリックしてダイアログを開いたままにします。キャンセルをクリックして変更を破棄し、ダイアログを閉じます。2025 年...

パス選択ダイアログ

パスの選択ダイアログでは、さまざまな状況でファイルまたはフォルダーの場所を指定できます。たとえば、実行する実行可能ファイル、使用する構成ファイル、テストまたはインスペクションの結果をエクスポートするファイルを指定する必要がある場合があります。ダイアログの名前と利用可能なオプションは、実行しているタスクによって異なります。現在のコンテキストで適用できない機能は通常無効になっています。たとえば、1 つの項目しか選択できない場合もあれば、複数の項目を選択できる場合もあります。また、フォルダーは選択でき...

ファイルのネスト規則

同じ名前だが接尾辞が異なるファイルの表示を設定できます。このようなファイルの束は、プレーンな構造として表示することも、親ファイルを子ファイルを含むフォルダー (ネスト) として表示することもできます。このようなファイルの束は、たとえば Angular を使用している場合、フレームワーク固有のプロジェクトに表示されることがあります。ファイルのネストを調整するプロジェクトツールウィンドウ () で、をクリックして外観を選択し、次にファイルのネストを選択します。ファイルのネスト規則を構成できるダイアログが...