高级配置

除了 IDE 设置中提供的标准选项外，WebStorm 还允许您对底层平台和 Java 运行时进行底层配置。

JVM 选项

WebStorm 运行于 Java 虚拟机（JVM）之上，可通过多种选项控制其性能。

用于运行 WebStorm 的默认选项在 IDE 安装目录中指定：

<IDE_HOME>\bin\webstorm64.exe.vmoptions

WebStorm.app/Contents/bin/webstorm.vmoptions

<IDE_HOME>/bin/webstorm64.vmoptions

配置 JVM 选项

请使用以下方法之一，在配置目录中创建一个包含 JVM 选项的默认文件副本，以覆盖原始文件：

在主菜单中，转到帮助 | 编辑自定义 VM 选项。
如果尚未打开任何项目，在欢迎界面点击配置然后编辑自定义 VM 选项。
如果无法启动 WebStorm，请手动将包含 JVM 选项的默认文件复制到 WebStorm 的配置目录。

如果您无权写入 WebStorm 配置目录，您可以添加环境变量 WEBIDE_VM_OPTIONS 来指定包含首选 JVM 选项的文件位置。该文件将覆盖默认文件和配置目录中的副本。该文件将覆盖默认文件和配置目录中的副本。

定位 JVM 选项文件

如果不确定 WebStorm 是从哪里获取 JVM 选项的，请检查以下内容：

由环境变量 WEBIDE_VM_OPTIONS 指定的位置。如果指定的文件存在，它会覆盖所有其他 JVM 选项文件。
如果当前的 WebStorm 是通过 Toolbox 应用程序管理的，打开 Toolbox 应用程序，点击相关 IDE 实例旁的，然后选择设置。在配置下，找到 Java 虚拟机选项，然后点击编辑。
如果正在运行独立的 WebStorm 实例，请检查配置目录。
如果在上述位置未定义 JVM 选项文件，WebStorm 将使用默认 JVM 选项文件。请勿修改该文件。请仅用于查看 WebStorm 使用的默认选项。

常用选项

JVM 选项的默认值在大多数情况下都是最佳的。以下是最常被修改的选项：

-Xmx

限制 JVM 为运行 WebStorm 可分配的最大堆内存大小。默认值取决于平台。如果遇到运行缓慢的问题，建议增加该值，例如将其设置为 2048 MB，可将此选项更改为 -Xmx2048m。

-Xms

指定 JVM 为运行 WebStorm 分配的初始内存大小。默认值取决于平台。通常设置为最大允许内存的一半（参见 -Xmx ），例如 -Xms1024m。

-XX:NewRatio

指定堆中新生代与老年代的比率。在大多数情况下，建议设置为 2 到 4 之间的比率。这会将新生代设置为老年代的 1/2 到 1/4，对于经常同时仅处理一个项目和少量文件的情况较为合适。但如果经常打开新文件并在多个项目之间切换，可能需要增大新生代。此时，尝试设置 -XX:NewRatio=1 ，这会使新生代大小等于老年代，从而延长对象在新生代中的驻留时间。

如需了解更多信息，请参见 Java 垃圾回收基础。

每个选项请另起一行。 JVM 选项文件示例：

                -Xmx4G
                -Xms2G
                -XX:NewRatio=4
            
   

有关可用 JVM 选项的详细信息，请参阅 java 命令参考。

平台属性

WebStorm 使您能够自定义各种特定于平台的属性，例如用户安装插件的路径和支持的最大文件大小。运行 WebStorm 时使用的默认属性在 IDE 安装目录中指定：

<IDE_HOME>\bin\idea.properties

WebStorm.app/Contents/bin/idea.properties

<IDE_HOME>/bin/idea.properties

配置平台属性：

通过以下任一方法在配置目录中创建一个空的 idea.properties 文件，以覆盖原始文件中的值：

转到帮助 | 编辑自定义属性。
如果未打开任何项目，在欢迎屏幕中点击配置，然后选择编辑自定义属性。
如果无法启动 WebStorm，请在 WebStorm 的配置目录中手动创建一个空的 idea.properties 文件。

如果您无权写入 WebStorm 配置目录，可添加 WEBIDE_PROPERTIES 环境变量以指定 idea.properties 文件的位置。此文件中的属性将覆盖原始默认文件及 WebStorm 配置目录中的文件中的相应属性。

常用属性

用户常常更改默认 IDE 目录的位置。有关更多信息，请参阅更改 IDE 目录的位置。

可能影响性能的限制：

idea.max.content.load.filesize: WebStorm 能够打开的文件的最大大小（以 KB 为单位）。处理大型文件可能会影响编辑器性能并增加内存消耗。默认值为 20000。
idea.max.intellisense.filesize: WebStorm 提供代码辅助功能的文件最大大小（以 KB 为单位）。对大型文件提供代码辅助可能影响编辑器性能并增加内存消耗。默认值为 2500。
idea.cycle.buffer: 控制台循环缓冲区的最大大小（以 KB 为单位）。如果控制台输出大小超过此值，则最早的行将被删除。要禁用循环缓冲区，请设置 idea.cycle.buffer.size=disabled。
idea.max.vcs.loaded.size.kb: 在比较更改时，WebStorm 为显示文件旧内容而加载的最大大小（以 KB 为单位）。默认值为 20480。

请将每个属性指定为单独一行。平台属性文件示例：

                idea.max.intellisense.filesize=5000
                idea.cycle.buffer.size=1024

WebStorm 还提供多种其他属性，用于定义与环境（窗口管理器、启动器、文件系统等）的交互方式。其中大多数属性表现为隐藏设置（即未显式公开），在某些情况下您可能需要启用或禁用这些设置。仅在获得 JetBrains 技术支持建议的情况下才更改这些属性。

增加堆内存

运行 WebStorm 的 Java 虚拟机（JVM）会分配一定的预定义内存。默认值因平台而异。如果出现性能变慢现象，您可能需要增加内存堆大小。

转到帮助 | 更改内存设置。在打开的内存设置对话框中，设置您希望分配的内存数量，然后点击保存并重启。
这将更改 JVM 使用的 -Xmx 选项的值，并以新设置重新启动 WebStorm。
如果在垃圾回收后可用堆内存少于最大堆大小的 5%，WebStorm 也将向您发出警告：
点击配置以增加 JVM 分配的内存：
点击保存并重启并等待 WebStorm 以新的内存堆设置重新启动。

在状态栏上启用内存指示器

WebStorm 可在状态栏中显示已使用内存量。可利用该信息判断应分配多少内存。

右键点击状态栏并选择内存指示器。

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