IntelliJ IDEA 2025.3 Help

语言服务

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

配置内存处理

尽管 IntelliJ IDEA 努力与语言服务进行良好集成,但仍可能出现由语言服务引起而非 IntelliJ IDEA 本身导致的 内存不足 错误。

内存处理模式

当语言服务内存不足时,IntelliJ IDEA 会首先尝试重启该服务。 在连续两次尝试失败后,语言服务将停止,IntelliJ IDEA 会在状态栏的 语言服务 微件中指示该错误,并显示包含错误消息的弹出窗口。

为防止 内存不足 错误或无缝解决此类错误,从而确保语言服务稳定运行,您可以按以下两种模式配置内存处理:

自动增加内存

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

IntelliJ IDEA 会以静默方式持续采用这种方式,直至达到 RAM 的 25% 最大内存上限,此时语言服务将停止,IntelliJ IDEA 会显示包含错误消息的弹出窗口。

有关改善情况的可能步骤,请参见 故障排除

设置内存限制

在此模式下,您可以手动指定语言服务可使用的最大内存。 在达到该上限之前,IntelliJ IDEA 会在每次发生 内存不足 错误时建议增加 1000MB。

当达到指定上限时,语言服务将停止,IntelliJ IDEA 会显示包含错误消息的弹出窗口。

有关改善情况的可能步骤,请参见 故障排除

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

  1. Ctrl+Alt+S 打开设置,然后转到 设置 | 语言和框架 | 语言服务 | TypeScript

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

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

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

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

故障排除

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

  • 您当前处理的项目包含大量文件和依赖。

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

增加内存分配

  1. Ctrl+Alt+S 打开设置,然后转到 设置 | 语言和框架 | 语言服务 | TypeScript

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

  3. 逐步提高上限,例如,从 4GB 增至 6GB,再到 8GB。 监控改进情况。

限制您的项目范围

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

    升级或降级

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

      IntelliJ IDEA 随附了捆绑的语言服务版本。 不过,较新版本的语言服务通常包含性能改进。 因此,建议您保持语言服务为最新状态。

      要安装语言服务的最新版本,请打开内置的 终端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
    • 如果在更新语言服务后出现问题,请考虑降级到先前版本,以确认问题是否由该更新引入。

    在 IntelliJ IDEA 问题跟踪器中提交问题

    如果问题仍然存在,请在 IntelliJ IDEA 问题跟踪器 中提交问题,并附上您的项目。 这将帮助我们更高效地复现并调查该问题。

      2026年 1月 23日