# 语言服务

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

CLion 依赖 TypeScript、Vue、Astro、Svelte 及其他特定框架的语言服务来提供自动补全、代码分析和错误突出显示。

## 配置内存处理

尽管 CLion 致力于与语言服务实现顺畅集成，但仍可能发生由语言服务而非 CLion 本身引起的  out-of-memory 错误。

### 内存处理模式

当语言服务内存耗尽时，CLion 会首先尝试重新启动该服务。 连续两次尝试失败后，语言服务将停止，CLion 会在状态栏中的   语言服务   小部件中提示错误，并显示含有错误信息的弹出窗口。

为了防止  out-of-memory 错误或无感解决这些错误，以确保语言服务的稳定运行，您可以按以下两种模式配置内存处理：

#### 自动增加内存

在此模式下，当即将发生  out-of-memory 错误时，CLion 会自动增加 1000MB 内存，并在后台重启语言服务。

CLion 会持续静默使用该方式，直到达到最大内存限制（25% RAM）。此时语言服务将停止，CLion 会显示一个包含错误信息的弹出窗口。

有关改善此情况的可能措施，请参阅 [故障排查](#ls_troubleshooting)。

#### 设置内存限制

在此模式下，您可以手动指定语言服务可使用的最大内存。 未达到此上限前，每次  out-of-memory  错误发生时，CLion 均会建议增加 1000MB 内存。

当达到指定内存上限时，语言服务将停止，CLion 会显示一个包含错误信息的弹出窗口。

有关改善此情况的可能措施，请参阅 [故障排查](#ls_troubleshooting)。

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

> **Note:**
> Vue、Svelte、Astro 等语言服务的内存处理设置始终继承自 TypeScript 语言服务。

Procedure:

1. 通过按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，并导航到  `设置 | 语言与框架 | TypeScript` 。

2. 在   语言服务内存   区域中，选择内存处理模式：

* 在 语言服务内存 区域中，选择 在可用时自动增加内存 以增加内存并静默重启语言服务。

* 或者，选择 设置内存限制 并指定语言服务可使用的最大内存。 如果指定的内存大小超过了可用 RAM，CLion 会在工具提示中建议一个合适的值。 > **Note:** > 请确保您的计算机具有足够的可用内存。 如果当前内存分配已高，例如 8GB 以上，请考虑 [升级或降级](#ls_upgrade_downgrade)版本，或 [限制项目范围](#ls_limit_project_scope)。

## 故障排查

### 内存不足错误

当语言服务超出其分配的内存限制并无法继续处理工作负载时，会发生  out-of-memory 错误。 这通常由以下原因导致：

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

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

Procedure: 增加内存分配

1. 通过按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，并导航到  `设置 | 语言与框架 | TypeScript` 。

2. 在   语言服务内存   区域中，选择   设置内存限制   选项。

3. 请逐步提高内存限制，例如先从 4GB 提高至 6GB，再提升至 8GB。 监测性能提升情况。

Procedure: 限制项目范围

包含过多文件或依赖项的大型项目可能会使语言服务超载。 要降低大型代码库中的负载，请遵循 TypeScript 团队提供的 [性能指南](https://github.com/microsoft/Typescript/wiki/Performance)，特别是 [使用项目引用](https://github.com/microsoft/Typescript/wiki/Performance#using-project-references)和 [配置 tsconfig.json 或 jsconfig.json](https://github.com/microsoft/Typescript/wiki/Performance#configuring-tsconfigjson-or-jsconfigjson)部分的建议。

> **Note:**
> 这些推荐做法适用于使用 TypeScript 语言服务的项目，也适用于依赖该语言服务的 Vue、Astro 和 Svelte 框架的项目。

Procedure: 升级或降级

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

CLion 随附了内置版本的语言服务。 但新版本的语言服务通常会带来性能提升。 因此，建议您保持语言服务为最新版本。

要安装语言服务的最新版本，请打开命令行 shell 或内置的   终端  （ `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS))），根据所用的语言服务和软件包管理器输入以下命令之一：

TypeScript:

```SHELL
npm install --save-dev typescript

```

或

```SHELL
pnpm add --save-dev typescript

```

或

```SHELL
yarn add --dev typescript

```

Vue:

```SHELL
npm install --save-dev @vue/language-server

```

或

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

```

或

```SHELL
yarn add --dev @vue/language-server

```

Svelte:

```SHELL
npm install --save-dev svelte-language-server typescript-svelte-plugin

```

或

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

```

或

```SHELL
yarn add --dev svelte-language-server typescript-svelte-plugin

```

Astro:

```SHELL
npm install --save-dev @astrojs/language-server

```

或

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

```

或

```SHELL
yarn add --dev @astrojs/language-server

```

* 如果更新语言服务后出现问题，请考虑回退至之前的版本，以确认是否由更新引起了该问题。

### TypeScript 服务无法启动

TypeScript 语言服务无法启动，且未显示任何相应通知。 因此，类型推断不可用，也不会显示补全或导入建议。

Procedure: 延长启动超时时间

1. 通过按下 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，并导航到  `设置 | 高级设置` 。

2. 在   JavaScript 和 TypeScript   区域中，增加   TypeScript 服务创业公司超时   字段中的值。

![TypeScript 服务创业公司超时](https://resources.jetbrains.com/help/img/idea/2026.3/ls_troubleshooting_startup_timeout.png)

### 在 CLion 问题跟踪器中提交问题

如果问题仍然存在，请在 [CLion 问题跟踪器](https://youtrack.jetbrains.com/issues/CPP)中提交问题，并将您的项目附加到该问题。 这有助于我们更高效地重现并分析该问题。

