# TypeScript

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

> **TL;DR**
> `文件 | 设置 | 语言与框架 | TypeScript`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 语言与框架 | TypeScript`  适用于 macOS
>
>
>
> `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)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)
>
>
>
> 必需插件：
>
>
>
> `JavaScript 和 TypeScript`  -  插件与 IntelliJ IDEA 捆绑在一起，并默认启用。

> **Warning:**
> 仅当  JavaScript 和 TypeScript  插件在   设置 | 插件   页面上启用，如 [管理插件](managing-plugins.html) 中所述时，此页面才可用。

## Node.js 运行时

在此字段中，指定要使用的 Node.js 运行时。

如果您选择   项目   别名， IntelliJ IDEA 将自动使用在 [JavaScript 运行时](javascript-runtime.html) 页面上   Node.js 运行时   字段中的项目默认解释器。 在大多数情况下， IntelliJ IDEA 会检测到项目的默认运行时，并自动填写该字段。

您还可以选择其他已配置的本地或远程解释器，或点击 ![浏览按钮](https://resources.jetbrains.com/help/img/idea/2026.3/app.general.ellipsis.svg) 并配置一个新的解释器。

## TypeScript

在此字段中，指定要使用的 TypeScript 版本（IntelliJ IDEA 显示当前选择的版本）。

* 默认使用项目 `node_modules` 文件夹中的 `typescript` 软件包。

* 捆绑： 选择此选项可使用随 IntelliJ IDEA 提供的 `typescript` 软件包，而不尝试查找其他软件包。

* 选择: 选择此选项可使用自定义 `typescript` 软件包，而不是随 IntelliJ IDEA 捆绑的软件包。 在打开的对话框中，选择相关包的路径。

* 如果您的项目包管理器是 [Yarn 2](https://yarnpkg.com/getting-started)，您必须使用通过 Yarn 2 安装的 `typescript` 包。 在这种情况下，默认会选中 `yarn:package.json:typescript` 。 有关软件包管理器的详细信息，请参阅 [npm 和 Yarn](installing-and-removing-external-software-using-node-package-manager.html#ws_npm_yarn_configure_package_manager)。

## TypeScript 语言服务

选中此复选框可根据最新规范获得 [TypeScript 语言服务](https://github.com/Microsoft/TypeScript/wiki/Using-the-Language-Service-API) 的原生支持。 结果：

* 语法和错误高亮显示基于 TypeScript 语言服务中的注解。

* 补全列表既包含来自 TypeScript 语言服务的建议，也包含由 IntelliJ IDEA 计算的建议。

* TypeScript 代码被编译成 JavaScript。

> **Tip:**
> 默认情况下，选中   TypeScript 语言服务   复选框。

|  条目  |  描述  |
| --- | --- |
|     显示项目错误     |     默认情况下，此复选框处于选中状态，TypeScript 语言服务会检查整个项目中的代码。 检测到的错误列在   项目错误  选项卡中 [问题工具窗口](problems-tool-window.html)，按发生错误的文件分组。       为避免性能问题，请清除   显示项目错误   复选框，使 TypeScript 语言服务仅在打开文件时检查文件。 随后，   项目错误   选项卡只会列出已打开文件中检测到的错误。     |
|     显示建议     |     默认情况下，此复选框处于选中状态，IntelliJ IDEA 除了显示实际错误外，还会显示 TypeScript 语言服务在代码中检测到的潜在问题。      显示建议已开启:    ![显示建议已启用](https://resources.jetbrains.com/help/img/idea/2026.3/typescript_settings_show_suggestions_on.png)   显示建议已关闭:    ![显示建议已禁用](https://resources.jetbrains.com/help/img/idea/2026.3/typescript_settings_show_suggestions_off.png)    |
|     启用服务驱动的类型引擎     |     选中此复选框以基于 TypeScript 编译器的数据评估符号的类型。       默认情况下，该复选框已清除，因此类型评估、解析、代码检查和重构操作基于 IntelliJ IDEA 内部 TypeScript 引擎中的类型信息。       此默认行为可能会导致性能问题以及类型解析中的错误，因为 IntelliJ IDEA 内部 TypeScript 引擎使用的类型评估算法与 TypeScript 编译器的算法不同。 选中该复选框可能有助于避免这些问题。      > **Note:** > 如果选中   TypeScript 语言服务   复选框，无论   启用服务驱动的类型引擎   复选框是选中还是清除，某些代码高亮显示和补全始终会从 TypeScript 语言服务检索。    |
|     更改时重新编译     |      * 选中此复选框后，编译器会在 TypeScript 文件发生任何更改时“唤醒”。    * 清除此复选框时，编译器将忽略对 TypeScript 文件的更改。    |
|  选项  |     在此字段中，指定在找不到  `tsconfig.json`  文件时要传递给 TypeScript 语言服务的命令行选项。 请参阅 [TSC arguments](http://www.typescriptlang.org/docs/handbook/compiler-options.html)中的可接受选项列表。 请注意，  `-w`  或  `--watch` （  观看输入文件 ）选项无关紧要。     |

> **Tip:**
> 可以使用来自 TypeScript 语言服务的建议来增强 JavaScript 文件中的补全。 为此，请将  `'allowJS' : true`  添加到  `jsconfig.json`  或  `tsconfig.json`  文件中。 了解详情，请参阅 [代码补全](auto-completing-code.html) 和 [配置 JavaScript 库](configuring-javascript-libraries.html)。

## See also

### 过程

[TypeScript](typescript-support.html)