内容根

在 PyCharm 中，内容是您当前正在处理的一组文件，可能组织为子文件夹的层级结构。此层级结构中最顶层的文件夹称为内容根文件夹，或简称内容根（显示为）。项目至少具有一个内容根文件夹，默认情况下为项目文件夹本身。

拥有多个内容根使您能够处理来自多个目录的文件，这些目录没有共同的直接父目录。这在使用静态内容时很有用，例如图标。您可以将它们全部保存在一个文件夹中，然后在多个项目中将该文件夹指定为附加的内容根。

内容根类型

默认情况下，内容根文件夹中的所有文件都会参与索引、搜索、解析、代码补全等操作。要更改此状态，可以将内容根内的文件夹分配到以下类别：

常规内容根，按配置项目结构中所述创建。这些根标记为。
内容根是包含构成项目的文件的文件夹。
源
这些根包含实际的源文件和资源。 PyCharm 使用源根作为解析导入的起点。
源根下的文件将根据其类型进行处理。 PyCharm 可以解析、检查、索引并编译这些根的内容。
排除
这些根包含在索引、搜索、解析、监视等过程中会被 PyCharm 忽略的文件和文件夹。
通常，您可能希望排除临时构建文件夹、生成的输出、日志和其他项目输出。排除不必要的路径是显著提升性能的有效方法。
  资源根（仅限 PyCharm Pro）
这些根用于应用中的资源文件（图像、样式表等）。可以相对于该文件夹引用资源根文件夹中的文件和子文件夹，而无需为其指定完整路径。
模板根（仅限 PyCharm 专业版）包含各种 Web 项目的模板。

最后修改日期： 2025年 12月 2日