PyCharm 2025.3 Help

TypeScript

Node.js 运行时

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

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

您也可以选择其他已配置的本地或远程解释器,或点击 浏览按钮 配置新的解释器。

TypeScript

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

  • 默认情况下,使用来自项目 node_modules 文件夹的 typescript 包。

  • 内置: 选择此选项以使用随 PyCharm 提供的 typescript 包,而不尝试查找其他包。

  • 选择: 选择此选项以使用自定义 typescript 包,而不是使用随 PyCharm 捆绑的包。 在打开的对话框中,选择相关包的路径。

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

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

TypeScript 语言服务

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

  • 语法和错误高亮显示基于来自 TypeScript 语言服务的注解。

  • 补全列表同时包含来自 TypeScript 语言服务的建议和由 PyCharm 计算的建议。

  • TypeScript 代码被编译为 JavaScript。

描述

显示项目错误

默认情况下,会选中此复选框,并且 TypeScript 语言服务会检查整个项目的代码。 检测到的错误将按发生的文件进行分组,列在 问题工具窗口项目错误 选项卡中。

为避免性能问题,请清除 显示项目错误 复选框,使 TypeScript 语言服务仅在您打开文件时才检查它们。 然后, 项目错误 选项卡将仅列出在您已打开的文件中检测到的错误。

显示建议

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

显示建议已启用
显示建议已禁用

启用服务驱动的类型引擎

选中此复选框,可基于来自 TypeScript 编译器的数据评估符号的类型。

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

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

更改时重新编译

  • 选中此复选框时,对 TypeScript 文件的任何更改都会使编译器 "唤醒"。

  • 清除此复选框时,编译器将忽略对 TypeScript 文件的更改。

选项

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

最后修改日期: 2025年 12月 2日