内容根
在 PyCharm 中, 内容 是您当前正在处理的文件集合,可能按子文件夹的层次结构组织。 此层级结构中最顶层的文件夹称为 内容根文件夹 ,或简称 内容根 (显示为 )。 项目至少具有一个内容根文件夹,默认情况下为项目文件夹本身。
拥有多个内容根使您能够处理来自多个目录的文件,这些目录没有共同的直接父目录。 这在使用静态内容时很有用,例如图标。 您可以将它们全部保存在一个文件夹中,然后在多个项目中将该文件夹指定为附加的内容根。
内容根类型
默认情况下,内容根文件夹中的所有文件都会参与项目分析、搜索、解析、代码补全等操作。 要更改此状态,可以将内容根内的文件夹分配到以下类别:
常规 内容根 ,按 配置项目结构 中所述创建。 这些根标记为
。
内容根是包含构成项目的文件的文件夹。
来源
这些根包含实际的源文件和资源。 PyCharm 使用源根作为解析导入的起点。
源根下的文件将根据其类型进行处理。 PyCharm 可以解析、检查、索引并编译这些根的内容。
排除
这些根包含在分析项目、搜索、解析、监视等过程中会被 PyCharm 忽略的文件和文件夹。
  资源根 (仅限 PyCharm Pro)
这些根用于应用中的资源文件(图像、样式表等)。 可以相对于该文件夹引用 资源根 文件夹中的文件和子文件夹,而无需为其指定完整路径。
模板根(仅限 PyCharm 专业版) 包含各种 Web 项目的模板。
在“项目”工具窗口中标记目录
在 项目工具窗口 中右键点击所需目录。
在上下文菜单中,指向 将目录标记为 节点。
选择 标记为 <目录状态>。
2026年 3月 24日