WebStorm 2025.3 Help

配置项目结构

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

您可以将任何文件夹添加为项目的一部分。 为此,只需按照 使用多个内容根 中的描述,在 Directories 页面上将此文件夹添加为新的内容根。

配置内容根中的文件夹

在内容根中,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年 12月 8日