IntelliJ IDEA 2025.2 Help

运行和调试 TypeScript

使用 IntelliJ IDEA,您可以运行并调试在 Node.js 上运行的服务器端 TypeScript 代码以及在浏览器中运行的客户端 TypeScript 代码。

运行并调试服务器端 TypeScript

使用 IntelliJ IDEA,您可以在不事先将其编译为 JavaScript 的情况下运行和调试服务器端的 TypeScript 代码。

对于运行和调试服务器端多个 TypeScript 文件应用程序,IntelliJ IDEA 使用内置加载器。 在运行或调试单个文件时,您可以通过从运行/调试配置中的 TypeScript 加载器 列表中选择 来关闭加载器。

开始之前

  1. 确保您的计算机上安装有 Node.js 18 或更高版本。

  2. 请确保在设置中启用了 Node.js 插件。 按 Ctrl+Alt+S 打开设置,然后选择 插件。 点击 已安装 选项卡。 在搜索字段中,输入 Node.js。 如需了解有关插件的更多信息,请参阅 管理插件

运行服务端 TypeScript 代码

您可以从 项目 工具窗口 Alt+1 、编辑器或 运行 小部件运行服务端 TypeScript。

  • 项目 工具窗口 Alt+1 中,右键点击要运行的 TypeScript 文件或应用程序的起始文件,然后从上下文菜单中选择 运行 <TypeScript file name>

从 Project 工具窗口运行服务器端 TypeScript
  • 在编辑器中,打开要运行的 TypeScript 文件或您应用程序的起始文件,然后从列表中选择 运行 <TypeScript file name>

从编辑器运行服务器端 TypeScript
  • 在编辑器中,打开要运行的 TypeScript 文件或您的应用程序的起始文件。 然后,从工具栏上的 运行 小部件中选择 当前文件 ,然后点击其旁边的 运行图标

    或者,您可以从 运行 小部件中选择一个 之前创建的运行/调试配置 ,然后点击旁边的 运行图标

从运行小组件运行服务器端 TypeScript

运行 TypeScript 临时文件

要运行一个 scratch file,除了上述方法外,您还可以点击边栏中的 运行图标 ,并从列表中选择所需操作。

运行 TypeScript 临时文件

自动生成的临时运行/调试配置

无论您选择哪种方式运行服务端 TypeScript 代码,IntelliJ IDEA 都会创建一个类型为 Node.js 的临时运行/调试配置,您可以保存、编辑并重新使用它来运行和调试。

Node.js 运行/调试配置,用于运行和调试服务端 TypeScript

了解更多信息,请参阅 运行/调试配置

调试服务端的 TypeScript 代码

您可以从 项目 工具窗口 Alt+1 、编辑器或 运行 小部件调试服务端 TypeScript。

  1. 在必要的地方设置 breakpoints

  2. 项目 工具窗口中,右键点击要调试的 TypeScript 文件或应用程序的起始文件,并从上下文菜单中选择 调试 <TypeScript file name>

从 Project 工具窗口运行服务器端 TypeScript
  1. 在必要的地方设置 breakpoints

  2. 在编辑器中,打开要调试的 TypeScript 文件或应用程序的启动文件,然后从上下文菜单中选择 调试 <TypeScript file name>

从编辑器调试服务器端 TypeScript
  1. 在必要的地方设置 breakpoints

  2. 在编辑器中,打开要调试的 TypeScript 文件或您的应用程序的起始文件。 然后,从工具栏上的 运行 小部件中选择 当前文件 ,然后点击其旁边的 调试图标

    或者,您可以从 运行 小部件中选择一个 之前创建的运行/调试配置 ,然后点击旁边的 调试图标

调试服务器端 TypeScript 从 Run widget

调试 TypeScript 草稿文件

要调试一个 scratch 文件,除了上述方法,您还可以点击边栏中的 运行图标 ,然后从列表中选择所需的操作。

运行 TypeScript 临时文件

请使用 ts-node

如果 您 需要使用 Node.js 运行或调试单个 TypeScript 文件,您可以使用 ts-node ,而不是按照 将 TypeScript 编译为 JavaScript中描述的那样编译代码。

安装 ts-node

  • 在嵌入的 终端Alt+F12 )中输入:

    npm install&#xa0;--save-dev ts-node

创建自定义 Node.js 运行/调试配置用于 ts-node

  1. 前往 运行 | 编辑配置。 或者,从工具栏上的 编辑配置 小部件中选择 运行

    打开编辑配置对话框

    在打开的 编辑配置 对话框中,点击工具栏上的 添加 按钮("添加"按钮 ),然后从列表中选择 Node.js运行/调试配置:Node.js 对话框打开。

  2. 节点参数 字段中,添加 --require ts-node/register

  3. 指定要使用的 Node.js 解释器。

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

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

  4. 文件 字段中,指定要运行或调试的 TypeScript 文件。 根据您的工作流程,您可以显式地执行该操作或使用

    • 如果您总是要启动相同的 TypeScript 文件,请点击 浏览按钮 并在打开的对话框中选择此文件。 默认情况下,运行/调试配置会获取所选文件的名称。

    • 如果您需要启动不同的文件,请输入 $FilePathRelativeToProjectRoot$。 使用此 macro ,IntelliJ IDEA 将总是在活动编辑器选项卡中启动文件。

    ts-node 的自定义运行调试配置
  5. 如果必要,您可以在 应用程序形参(C) 字段中指定 ts-node 的其他参数(例如, --project tsconfig.json)。

  6. 保存配置。

使用 ts-node 运行服务器端 TypeScript

根据您在运行/调试配置中指定 TypeScript 文件的方式,执行以下操作之一:

  • 如果您手动输入了文件名,请从工具栏上的 运行 小部件中选择所需的配置,然后点击列表旁边的 运行按钮 或按 Shift+F10

  • 如果您指定了宏,请在编辑器中打开要运行的 TypeScript 文件,从工具栏上的 运行 小部件中选择 新创建的配置 ,然后点击 运行按钮 或按 Shift+F10

IntelliJ IDEA 在 运行 工具窗口中显示输出。

使用 ts-node 调试服务端 TypeScript

  1. 在需要调试的 TypeScript 文件中,根据需要设置 断点

  2. 根据您在运行/调试配置中指定 TypeScript 文件的方式,执行以下操作之一:

    • 如果 您 亲自输入了文件名,请从工具栏上的 运行 小部件中选择所需的配置,然后点击 调试按钮 或按 Shift+F9

    • 如果您指定了宏,请在编辑器中打开 TypeScript 文件进行调试,从 新创建的配置 中选择 运行 小部件并点击 调试按钮 或按 Shift+F9

运行并调试客户端 TypeScript

由于浏览器仅处理 JavaScript,您必须在运行或调试之前 编译您的客户端 TypeScript 代码

编译还可以生成 source maps ,以设置 TypeScript 代码和实际执行的 JavaScript 代码之间的对应关系。

将 TypeScript 编译为 JavaScript

您可以使用内置编译器或其他工具单独或作为构建过程的一部分来编译 TypeScript。

默认情况下,内置编译器会将生成的 JavaScript 文件和 sourcemap 输出到 TypeScript 文件旁边。

您可以通过 手动调用编译 ,使用 编译 操作,从 TypeScript 小部件上的 状态 工具栏,或 启用保存时自动编译

编译错误在 TypeScript 工具窗口 中报告。 此列表不会受到您对代码所做更改的影响,只有在您再次调用编译时才会更新。

工具窗口仅在您首次手动编译 TypeScript 代码后显示。 之后,工具窗口可以通过主菜单中的 查看 | 工具窗口 | TypeScript 或工具窗口栏访问。

开始之前

  1. Ctrl+Alt+S 打开设置,然后选择 语言与框架 | TypeScript

  2. 请确保选中 TypeScript 语言服务 复选框。

创建并配置 tsconfig.json

默认情况下,内置编译器不会创建让您在调试期间逐步执行 TypeScript 代码的源映射。 编译器默认情况下还会处理活动编辑器选项卡中的 TypeScript 文件或当前项目中的所有 TypeScript 文件。

您可以使用 tsconfig.json 文件,更改此默认行为以生成源地图并仅编译来自自定义范围的文件。

创建 tsconfig.json 文件

  1. 项目 工具窗口 Alt+1 中,选择包含您的 TypeScript 代码的文件夹(通常是项目根文件夹),然后从上下文菜单中选择 新建 | tsconfig.json 文件

  2. 要在编译过程中生成 source maps,请确保 sourceMap 属性设置为 true

  3. 可选

    要重写默认的编译范围,即整个项目,请添加 文件 属性,并按以下格式键入要处理的文件名称:

    "files" : ["<file1.ts>","<file2.ts>"],

配置 tsconfig.json 的作用范围

您可能需要对项目中的不同文件应用不同的 TypeScript 配置。

如果您安排资源使每个文件夹中的所有文件都根据相同的配置进行处理,这不是问题。 在这种情况下,您只需为每个文件夹创建一个单独的 tsconfig.json

但是,如果您希望对存储在同一文件夹中的文件应用不同的规则,则需要创建多个配置文件并为其配置作用域。

  1. 根据需要创建尽可能多的 tsconfig*.json 配置文件。

  2. 打开 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 文件类型 ,并确保所有这些文件的名称与 Typescript config 文件名模式列表中的模式匹配。

    如果有必要,请添加如下所述的模式 添加文件类型关联

    文件类型:tsconfig.json 模式
  3. 在每个 *tsconfig*.json 中,根据其设置指定要处理的文件:

    • 请在 文件 字段中明确列出文件名:

      "files" : ["<file1.ts>","<file2.ts>"],

      TSConfig 参考:文件 了解更多。

    • include 字段中,指定文件名或模式:

      "include" : ["<pattern1>, <pattern2>"]

      了解更多信息,请参阅 TSConfig Reference: Include

    • 要跳过名称匹配 include 字段中列出的模式的一些文件,请在 exclude 字段中列出它们的名称或模式:

      "exclude" : ["<pattern3>, <pattern4>"]

      TSConfig参考:Exclude 了解更多信息。

编译 TypeScript 代码

您可以 手动调用编译 ,或者让 IntelliJ IDEA 在代码每次更改时自动编译您的代码

或者,您可以配置一个构建过程,例如,使用 webpackbabel或其他工具。 了解更多关于 webpack with TypeScriptBabel with TypeScript 的信息。

手动编译

  1. 点击状态栏上的 语言服务 小组件。

  2. 点击 编译图标

    编译 TypeScript 代码

    编译 TypeScript 弹出窗口中,选择以下选项之一:

    • 要编译整个应用程序的 TypeScript 代码,请选择 全部编译

      或者,从任意打开的 TypeScript 文件的上下文菜单中选择 编译 TypeScript

      从文件的上下文菜单编译 TypeScript
    • 要编译一个文件,请在 编译 TypeScript 弹出窗口中选择其路径。

      TypeScript 小部件:编译当前文件
    • 要从自定义范围中编译文件,请确保它们列在 文件 属性中,您的 tsconfig.json 如上所述

      编译 TypeScript 弹出窗口中,选择 tsconfig.json 的路径。

      TypeScript 小部件:从 tsconfig.json 编译自定义范围

更改时自动编译

  • 打开 语言与框架 | TypeScript 设置页面&#xa0; Ctrl+Alt+S ,并选中 在更改时重新编译 复选框。

运行客户端 TypeScript 应用程序

由于浏览器仅处理 JavaScript,您必须在运行之前编译您的客户端 TypeScript 代码。

运行客户端 TypeScript

  1. 将 TypeScript 代码编译成 JavaScript

  2. 在编辑器中打开包含对生成的 JavaScript 文件引用的 HTML 文件。 此 HTML 文件不一定是实现应用程序起始页的文件。

  3. 请执行以下操作之一:

    • 从主菜单中选择 视图 | 在浏览器中打开(B) 或按 Alt+F2。 然后从列表中选择所需的浏览器。

    • 将鼠标悬停在代码上以显示浏览器图标栏: the IntelliJ IDEA 图标 Chrome Firefox Safari Opera Internet Explorer Edge。 点击指示所需浏览器的图标。

调试客户端 TypeScript

由于浏览器仅处理 JavaScript,您必须在调试之前 编译您的客户端 TypeScript 代码

在编译过程中,还可以生成 source maps ,它们设置了您的 TypeScript 代码与实际执行的 JavaScript 代码之间的对应关系。 因此,您可以在 TypeScript 代码中设置断点,启动应用程序,然后通过生成的 sourcemap 单步调试您的原始 TypeScript 代码。

如果您的应用程序运行在 内置 IntelliJ IDEA 服务器上,请参阅上面的 运行客户端 TypeScript 应用程序部分,您也可以以与 在内置服务器上运行的 JavaScript相同的方式调试它。

在内置服务器上调试客户端 TypeScript

调试在外部 web 服务器上运行的 TypeScript 应用程序

通常情况下,您可能希望调试运行在外部开发 Web 服务器上的客户端应用程序,例如,由 Node.js 提供支持的服务器。

在外部服务器上调试客户端 TypeScript
  1. 按照 配置 JavaScript 调试器 中的描述配置内置调试器。

  2. 要启用源映射生成,请打开您的 tsconfig.json 并将 sourceMap 属性设置为 true ,如 创建 tsconfig.json 文件 中所述。

  3. 配置并设置断点 在 TypeScript 代码中。

  4. 将应用程序在 development mode中运行。 通常您需要运行 npm start 来实现。

    通常,在此阶段 TypeScript 会被编译为 JavaScript,并生成源映射。 有关更多信息,请参阅 将 TypeScript 编译为 JavaScript

    当开发服务器准备就绪时,复制应用程序在浏览器中运行时的 URL 地址——您需要在运行/调试配置中指定此 URL 地址。

  5. 前往 运行 | 编辑配置。 或者,从工具栏上的 编辑配置 小部件中选择 运行

    打开编辑配置对话框

    在打开的 编辑配置 对话框中,点击工具栏上的 添加 按钮("添加"按钮 ),然后从列表中选择 JavaScript 调试。 在 运行/调试配置:JavaScript Debug对话框中,指定应用程序运行的 URL 地址。 此 URL 可以从浏览器地址栏中复制,如上文所述 第 3 步

    在外部服务器上调试客户端 TypeScript:运行配置
  6. 从工具栏上的 运行 部件列表中,选择新创建的 配置,然后点击其旁边的 调试按钮。 运行配置中指定的 URL 地址将在浏览器中打开,并会显示 调试工具窗口

    您可能需要刷新浏览器页面,以使 调试 工具窗口中的控件可用。

  7. 调试 工具窗口中,如常操作: 逐步执行程序停止并继续程序执行、 在暂停时检查程序 、查看调用堆栈和变量、设置监视、计算变量值、 查看实际 HTML DOM等。

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