PyCharm 2025.2 Help

内容根目录

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

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

内容根目录类型

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

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

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

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

    源根目录下的文件会根据其类型进行解释。 PyCharm 可以解析、检查、索引和编译这些根目录的内容。

  • 排除的根图标排除

    这些根目录包含在索引、搜索、解析、监视等操作中被 PyCharm 忽略的文件和文件夹。

    通常,您可能希望排除临时构建文件夹、生成的输出、日志和其他项目输出。 排除不必要的路径是显著提高性能的好方法。

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

    这些根目录用于您的应用程序中的资源文件(图像、样式表等)。 资源根目录文件夹中的文件和子文件夹可以相对于该文件夹进行引用,而无需指定它们的完整路径。

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

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

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

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

  3. 选择 标记为<directory status>

最后修改日期: 2025年 9月 26日