PyCharm 2026.1 Help

内容根

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

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

内容根类型

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

  • 常规 内容根 ,按 配置项目结构 中所述创建。 这些根标记为 内容根图标

    内容根是包含构成项目的文件的文件夹。

  • 来源

    这些根包含实际的源文件和资源。 PyCharm 使用源根作为解析导入的起点。

    源根下的文件将根据其类型进行处理。 PyCharm 可以解析、检查、索引并编译这些根的内容。

  • 排除根图标排除

    这些根包含在分析项目、搜索、解析、监视等过程中会被 PyCharm 忽略的文件和文件夹。

  • 资源根图标   资源根 (仅限 PyCharm Pro)

    这些根用于应用中的资源文件(图像、样式表等)。 可以相对于该文件夹引用 资源根 文件夹中的文件和子文件夹,而无需为其指定完整路径。

  • 模板文件夹图标模板根(仅限 PyCharm 专业版) 包含各种 Web 项目的模板。

在“项目”工具窗口中标记目录

  1. 项目工具窗口 中右键点击所需目录。

  2. 在上下文菜单中,指向 将目录标记为 节点。

  3. 选择 标记为 <目录状态>

2026年 3月 24日