WebStorm 2025.3 Help

项目设置

在 WebStorm 中，您可以为特定项目或在 IDE 级别全局配置设置。 有关更多信息，请参阅 配置 IDE。

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

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

  • workspace.xml 文件包含您的工作区偏好设置，包括 运行/调试配置。

  • 每个 xml 文件负责其自己的设置集，可以通过其名称识别： projectCodeStyle.xml 、 encodings.xml 、 vcs.xml 等。

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

您可以从主菜单中选择 WebStorm | 设置 （在 macOS 上），或 文件 ｜ 设置 （在 Windows 和 Linux 上），以配置项目设置。 或者，您可以按 Ctrl+Alt+S 显示 IDE 设置。

在 设置 对话框中，仅适用于当前项目的项目设置将标记为 项目设置 图标。 其他设置是 global的，并适用于所有现有项目。

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

共享您的项目设置

当团队在同一个项目上工作时，共享您的项目设置很有帮助，而如果您在多台机器上使用 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 与项目一起共享这些文件。

要在已存在的项目之间共享项目设置，您还可以使用 备份与同步插件。 您还可以 将设置导出到 ZIP 存档 ，并稍后将其导入到其他 IDE 实例。

新项目的默认设置

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

在新项目中访问默认设置

  • 在主菜单中，进入 文件 | 新建项目设置 | 设置 用于新项目.

如果您有一个带有设置和配置的项目，想要在新项目中重现，您可以将此项目保存为自定义项目模板，然后使用此模板进行产品创建。 了解更多信息，请参阅 项目模板。

如果您希望在现有项目之间共享项目设置，您可以使用 Backup and Sync 插件。 您还可以 将设置导出到 ZIP 存档 ，并稍后将其导入到其他 IDE 实例。

最后修改日期： 2025年 12月 8日
配置项目结构项目安全