WebStorm 2025.2 Help

配置项目结构

在 WebStorm 中, 内容 是您当前正在处理的文件的集合,可能以子文件夹的层级结构组织。 项目的顶层文件夹是其 内容根

您可以将任何文件夹添加为项目的一部分。 要实现此操作,只需在 目录页面上将该文件夹添加为新的内容根,如 使用多个内容根中所述。

配置内容根中的文件夹

在内容根内,WebStorm 可区分包含编辑源代码的文件夹与包含其他内容类型的文件夹。 默认情况下,任何文件夹都被视为 源目录 ,并以 源代码文件夹 图标表示,除非将其标记为其他类型:

  • 测试 测试文件夹 文件夹可使您将测试相关代码与生产代码分离。

  • 资源根目录 资源根目录 文件夹:位于 资源根目录文件夹内的文件可以使用相对路径进行引用,而无需指定完整路径。 例如,当您在 HTML img 标签的 src 属性中开始键入时,代码补全会建议来自 资源根 文件夹的图像。

  • 排除 排除 文件夹将在代码补全、导航和检查中被忽略。 排除当前不需要的文件夹和特定文件,有助于提高 WebStorm 的性能。

配置文件夹的类别

  • 项目 工具窗口中右键单击该文件夹,从上下文菜单中选择 标记目录为 ,然后选择所需类别。

    选择文件夹类别
  • 或者,打开 设置 对话框(Ctrl+Alt+S ),转到 目录 ,然后配置文件夹的类别。

还原文件夹之前的类别

  • 项目 工具窗口中右键单击该文件夹,从上下文菜单中选择 标记目录为 ,然后选择 取消标记为〈当前类别〉。 对于 排除文件夹,选择 取消排除

排除文件

如果目前不需要某个文件,但又不想将其彻底删除,您可以将其临时从项目中排除。 排除的文件将在代码补全、导航和检查中被忽略。

  • 要排除文件,请在 项目 工具窗口中右键单击该文件,然后从菜单中选择 覆盖文件类型

    将文件从项目中排除:覆盖文件类型

    选择文件类型 列表中,选择 纯文本

    将文件从项目中排除:选择文件类型

    该文件将在目录树中显示为 纯文本 图标。

  • 若要恢复更改,请右键单击该文件,然后从菜单中选择 还原文件类型覆盖

    撤销文件类型的覆盖

按名称模式排除文件和文件夹

  1. 设置 对话框(Ctrl+Alt+S )中,进入 目录

  2. 排除文件 字段中键入用于定义要排除的文件和文件夹名称的掩码,例如 *.min.jslib。 使用分号作为分隔符。

    • 如果文件名符合任一模式,则此文件将被视为已排除。

    • 如果文件夹名称符合某一模式,则该文件夹及其子文件夹下的所有文件将被排除。

    请注意,通过名称模式排除的文件夹将在 项目 工具窗口中标记为排除,但不会添加到 排除的文件夹 列表中。

示例

如下图所示,模式 *mal.ts 会将文件 mammal.ts animal.ts 排除。

按名称排除文件

模式 lib 会排除两个文件夹 — lib src/lib

按名称排除文件夹

若只想排除 lib 文件夹,请在 目录 页面中选中它,然后点击 已排除

显式排除特定文件夹

使用多个内容根

您的项目中可以包含多个内容根。 这允许您处理来自多个不具备共同直接父级目录的文件。 这在使用静态内容时非常有用,例如图标。 您可以将它们全部存储于一个文件夹中,然后将该文件夹作为内容根添加到多个项目中。

设置 对话框(Ctrl+Alt+S )中,点击 目录

  • 要添加内容根,在右侧窗格中点击 添加内容根目录 ,然后在打开的对话框中选择所需的文件夹。

    添加新的内容根
  • 要移除内容根,在右侧窗格中选择它,然后点击旁边的 取消。 确认删除。 请注意,相应的文件夹不会被物理删除。

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