WebStorm 2025.2 Help

项目设置

在 WebStorm 中,您可以为特定项目或整个 IDE 全局配置设置。 有关详细信息,请参阅 配置 IDE

项目级别设置仅应用于当前项目。 这些设置作为 xml 文件存储在项目文件夹中的 .idea 目录中:

  • <项目名称>.iml 文件描述项目结构。

  • workspace.xml 文件包含您的工作区首选项,包括 运行/调试配置

  • 每个 xml 文件负责一组自己的设置,可通过文件名识别: projectCodeStyle.xml encodings.xml vcs.xml 等。

    因此,例如,添加新的运行/调试配置和更改编码将影响两个不同的 xml 文件。 这有助于在项目设置存储在版本控制系统中并被不同团队成员修改时避免合并冲突。

若要配置项目设置,请在 macOS 上从主菜单选择 WebStorm|设置 ,或在 Windows 和 Linux 上选择 文件| 设置。 或者,您也可以按 Ctrl+Alt+S 以显示 IDE 设置。

设置 对话框中,仅应用于当前项目的项目设置会以 项目设置 图标标记。 其他设置为 全局设置,适用于所有现有项目。

“设置”对话框中标记的项目和全局设置

共享项目设置

在团队协作同一项目时共享项目设置非常有用,而若在多台机器上使用 WebStorm,则 ide 设置备份和同步 也可派上用场。

如果项目在版本控制中,建议将 .idea 目录中的所有 XML 文件(除 workspace.xml 外)纳入版本控制。 workspace.xml 文件存储的是不应共享的用户特定设置。

有关应忽略内容的更多信息,请参阅 GitHub 上的 JetBrains.gitignore

配置文件将根据您的选择进行处理。 在修改项目设置并创建新配置文件后,IDE 会在屏幕底部显示通知,提示您选择如何处理该项目中的配置文件:

  • 查看文件 :查看已创建的配置文件列表,并选择要纳入版本控制的文件。 之后,所选文件将安排添加到 VCS。

  • 始终添加 :自动将 .idea 目录中创建的所有配置文件安排添加进 VCS(仅适用于当前项目)。

  • 不再询问 :从不将配置文件安排添加至 VCS;文件将保持 未版本控制状态,直到您手动将其纳入 VCS(仅适用于当前项目)。

如果关闭通知而未选择任意选项,则在创建新配置文件后,通知将再次出现。 即使您重新启动 IDE,该新文件也会保留在该列表中,直到您选择某个选项。

提示如何处理配置文件的通知

不可共享配置文件列表

WebStorm 会自动识别配置文件并将其添加到忽略文件列表中。 但如果您是手动共享项目,我们建议避免将以下文件和文件夹纳入版本控制:

  • .idea/workspace.xml

  • .idea/usage.statistics.xml

  • .idea/dictionaries 文件夹

  • .idea/shelf 文件夹

完整文件列表请参阅 如何管理版本控制系统下的项目JetBrains.gitignore

复制全局设置至项目级别

全局(IDE)设置与项目分开存储。 因此,这些设置不会通过版本控制随项目共享。

不过,一些设置可以复制到项目级别。 例如,您可以复制 检查配置文件 ,以及 从代码补全和自动导入中排除的类和包列表。 如果如此操作,IDE 会在 .idea 目录中创建相应的配置文件,您可以将其与项目一起通过 VCS 共享。

若要在已存在的项目之间共享项目设置,您也可以使用 Backup and Sync 插件。 您还可以 将设置导出为 ZIP 归档 ,并稍后导入到其他 IDE 实例中。

新项目的默认设置

您不仅可以为当前项目配置项目设置,还可以为将来创建的所有项目配置设置。 这意味着您可以为项目设置新的默认设置。

访问新项目的默认设置

  • 在主菜单中,转到 文件| 新建项目设置|新项目的 设置

如果您有一个具有所需设置和配置的项目,并希望在新项目中复用它,可以将该项目保存为自定义项目模板,然后用于创建新项目。 详细了解,请参阅 项目模板

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