PhpStorm 2025.2 Help

语言服务

PhpStorm 依赖于 TypeScript、Vue、Astro、Svelte 以及其他特定框架的语言服务来提供自动补全、代码分析和错误高亮。

配置内存处理

尽管 PhpStorm 致力于与语言服务实现流畅集成,但仍可能会出现由语言服务而非 PhpStorm 本身引发的 内存溢出错误。

内存处理模式

当语言服务出现内存溢出时,PhpStorm 会首先尝试重启该服务。 连续两次重启失败后,语言服务将停止,PhpStorm 会在状态栏的 语言服务 小组件中指示错误,并弹出错误消息提示框。

为防止 内存溢出错误或实现其自动修复,从而确保语言服务稳定运行,您可以在以下两种模式下配置内存处理:

自动增加内存

在此模式下,当即将发生 内存溢出错误时,PhpStorm 会自动增加 1000MB 内存并在后台重启语言服务。

PhpStorm 会以此方式静默运行,直到内存使用达到最多可用 RAM 的 25%,届时语言服务将停止,PhpStorm 会弹出错误消息提示框。

关于可能的改进措施,请参阅 故障排查

设置内存限制

在此模式下,您需手动指定语言服务可使用的最大内存。 在达到该限制前,每次出现 内存溢出错误时,PhpStorm 会建议增加 1000MB 内存。

在达到指定限制后,语言服务将停止,PhpStorm 会弹出错误消息提示框。

关于可能的改进措施,请参阅 故障排查

为 TypeScript 语言服务配置内存处理

  1. 按下 Ctrl+Alt+S 打开设置,并导航到 设置 | 语言与框架 | 语言服务 | TypeScript

  2. 语言服务内存 区域选择内存处理模式:

    • 选择 如可用,自动增加内存 以自动增加内存并在后台重启语言服务。

    • 或者,选择 设置内存限制 并指定语言服务可使用的最大内存。

      如果指定的内存大小超过可用 RAM,PhpStorm 会在工具提示中建议一个合适的数值。

故障排查

当语言服务超出其分配的内存限制,无法继续处理工作负载时,就会发生 内存溢出错误。 这通常由以下原因导致:

  • 当前使用的项目包含大量文件和依赖项。

  • 在 IDE 设置中指定的最大内存限制不足以满足语言服务的需求。

增加内存分配

  1. 按下 Ctrl+Alt+S 打开设置,并导航到 设置 | 语言与框架 | 语言服务 | TypeScript

  2. 请选择 设置内存限制 选项。

  3. 请逐步增加内存限制,例如从 4GB 增加至 6GB,然后再到 8GB。 监测性能提升情况。

限制项目范围

包含过多文件或依赖项的大型项目可能会使语言服务过载。 为减少大型代码库的负载,请遵循 TypeScript 团队提供的 性能指南中的建议,特别是 使用项目引用配置 tsconfig.json 或 jsconfig.json部分。

    升级或降级

    • 请确保您使用的是最新版本的语言服务。

      PhpStorm 附带打包好的语言服务版本。 然而,新版本的语言服务通常包含性能改进。 因此,建议保持语言服务为最新版本。

      要安装语言服务的最新版本,请打开内置的 终端Alt+F12 ),然后根据所使用的语言服务和包管理器输入以下命令之一:

      npm install --save-dev typescript

      pnpm add --save-dev typescript

      yarn add --dev typescript
      npm install --save-dev @vue/language-server

      pnpm add --save-dev @vue/language-server

      yarn add --dev @vue/language-server
      npm install --save-dev svelte-language-server typescript-svelte-plugin

      pnpm add --save-dev svelte-language-server typescript-svelte-plugin

      yarn add --dev svelte-language-server typescript-svelte-plugin
      npm install --save-dev @astrojs/language-server

      pnpm add --save-dev @astrojs/language-server

      yarn add --dev @astrojs/language-server
    • 如果在更新语言服务后出现问题,建议回退至上一个版本以确认问题是否由更新引起。

    在 PhpStorm 问题跟踪器中提交问题

    如果问题依然存在,请在 PhpStorm 问题跟踪器中提交问题,并附上项目。 这样将有助于我们更高效地复现并调查该问题。

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