WebStorm 2025.2 Help

TypeScript

Node 解释器

在此字段中,指定要使用的 Node.js 解释器。

如果选择 项目 别名,WebStorm 将自动使用 Node.js 页面中 Node 解释器 字段的项目默认解释器。 在大多数情况下,WebStorm 会检测项目默认解释器并自动填写此字段。

您也可以选择另一个已配置的本地或远程解释器,或单击 浏览按钮 来配置一个新的解释器。

如需了解详情,请参阅 配置远程 Node.js 解释器配置本地 Node.js 解释器在 Windows 子系统 Linux 中使用 Node.js

TypeScript

在此字段中,指定要使用的 TypeScript 版本(WebStorm 会显示当前选择的版本)。

  • 默认使用项目 node_modules 文件夹中的 typescript 包。

  • 内置: 选择此选项可使用随 WebStorm 附带的 typescript 包,而不尝试查找其他包。

  • 选择: 选择此选项可使用自定义 typescript 包,而非随 WebStorm 附带的包。 在打开的对话框中,选择相关包的路径。

  • 如果您的项目包管理器是 Yarn 2 ,则必须使用通过 Yarn 2 安装的 typescript 包。 在此情况下,默认会选择 yarn:package.json:typescript

    有关包管理器的更多信息,请参阅 npm 和 Yarn

TypeScript 语言服务

选中此复选框以根据最新规范从 TypeScript 语言服务 获取原生支持。 因此:

  • 语法和错误高亮基于 TypeScript 语言服务的注释。

  • 补全列表包含来自 TypeScript 语言服务以及 WebStorm 计算的建议。

  • TypeScript 代码被编译为 JavaScript。

项目

说明

显示项目错误

默认情况下,将选中此复选框,TypeScript 语言服务会检查整个项目中的代码。 检测到的错误显示在 项目错误 标签页的 “问题”工具窗口 中,按出错文件分组。

为避免性能问题,请取消选中 显示项目错误 复选框,使 TypeScript 语言服务仅在您打开文件时才进行检查。 然后, 项目错误 标签页将仅列出您已打开文件中检测到的错误。

显示建议

默认情况下选中此复选框,除实际错误外,WebStorm 还会显示 TypeScript 语言服务在代码中检测的潜在问题。

已启用建议功能
已禁用建议功能

启用基于服务的类型引擎

选中此复选框以基于 TypeScript 编译器的数据对符号类型进行评估。

默认情况下未选中此复选框,类型评估、解析、代码检查和重构均基于 WebStorm 内部 TypeScript 引擎中的类型信息。

此默认行为可能会导致性能问题以及类型解析中的错误,因为 WebStorm 内部 TypeScript 引擎使用的类型评估算法与 TypeScript 编译器的算法不同。选中此复选框可以帮助避免这些问题。 选中此复选框可以帮助避免这些问题。

更改后重新编译

  • 选中此复选框后,每当 TypeScript 文件更改时,编译器会“唤醒”。

  • 取消选中此复选框后,编译器将忽略对 TypeScript 文件的更改。

选项

在此字段中,指定当未找到 tsconfig.json 文件时传递给 TypeScript 语言服务的命令行选项。 有关可接受选项的列表,请参阅 TSC 参数。 请注意, -w--watch监视输入文件 )选项不适用。

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