PyCharm 2025.3 Help

测试 TypeScript

从 20 版开始,Node.js 随附稳定版的 内置 Node.js 测试运行器。 PyCharm 支持与内置测试运行器集成,因此您无需安装和配置任何第三方框架即可运行测试。

PyCharm 提供对 ts-nodetsx 加载器的开箱即用配置,因此您无需事先将 TypeScript 测试编译为 JavaScript,即可运行和调试这些测试。 或者,您可以安装自定义加载器,并按照 创建 Node.js Test Runner 运行/调试配置 中的说明进行配置。

您可以直接在编辑器中运行和调试测试,或启动类型为 Node.js 测试运行器 的运行/调试配置。

开始之前

  1. 请确保您的计算机已安装 Node.js 20 或更高版本,并将其配置为 本地 Node.js 运行时

  2. 安装加载器。 在嵌入式 终端Alt+F12 )中,输入:

    • npm install --save-dev ts-node 以安装 ts-node

    • npm install --save-dev tsx 以安装 tsx

从编辑器运行测试

  • 要运行某个测试,请点击其旁边的标记栏中的 运行测试图标 ,然后在列表中选择 运行 '<测试名称>'

    使用 Node.js 内置测试运行器从编辑器运行测试
  • 要运行套件中的所有测试,请点击其旁边的标记栏中的 运行所有测试图标 ,然后在列表中选择 运行 '<测试套件名称>'

    使用 Node.js 内置测试运行器从编辑器运行测试套件

通过运行配置运行测试

当您需要从多个测试文件运行测试时,通过运行/调试配置运行测试会很有帮助。 使用运行/调试配置的另一优势是可以配置自定义加载器。

Node.js Test Runner 运行/调试配置

您可以自行创建运行/调试配置,或者保存、编辑并复用当您从编辑器运行测试或套件时 PyCharm 创建的类型为 Node.js 测试运行器临时运行/调试配置

  1. 转到 运行 | 编辑配置。 或者,在工具栏的 运行 小部件中选择 编辑配置

    打开编辑配置对话框

    或者,选择先前生成的临时运行/调试配置。

  2. 在打开的 编辑配置 对话框中,点击工具栏上的 添加 按钮(添加按钮 ),并在列表中选择 Node.js 测试运行器

    将打开 运行/调试配置:Node.js 测试运行器 对话框。

  3. 指定要使用的 Node.js 运行时、工作目录,并选择要运行的测试范围。

  4. 语言 列表中,选择 TypeScript

  5. 加载器 列表中,选择要使用的加载器。 默认情况下,提供与 tsxts -node 的开箱即用集成。

    或者,安装并配置自定义加载器。 例如,安装 jiti 并在 Node 选项 字段中输入 -r jiti/register

    TypeScript 测试:配置自定义加载器
  6. 点击 运行

    或者,在 运行 小部件中选择一个现有的运行/调试配置,并点击其旁边的 调试图标

查看测试结果

测试结果会显示在 运行 工具窗口中。

测试结果

了解更多,请参阅 探索测试结果

重新运行测试

  • 要重新运行单个测试,请在 运行 工具窗口中选择它,并在其上下文菜单中选择 运行 '<测试名称>' ,或按 Alt+Shift+R

    从运行工具窗口重新运行单个测试

    或者,使用测试旁边的标记栏图标重新运行。 点击 运行已忽略的测试图标重新运行失败测试图标重新运行成功测试图标 以重新运行被忽略、失败或成功的测试,并在列表中选择 运行 '<测试名称>'

    从标记栏重新运行单个测试
  • 要重新运行整个套件,请点击套件旁边的标记栏图标,并在列表中选择 运行 '<测试套件名称>'

    从标记栏重新运行测试套件
  • 要重新运行上一会话中的所有测试,请在 运行 工具窗口的工具栏上点击 重新运行 '<suite name>' 图标

    重新运行测试套件

调试测试

  1. 根据需要设置 断点

  2. 开始调试:

    • 要调试某个测试,请点击测试旁边标记栏中的 运行测试图标 ,然后在列表中选择 调试 '<测试名称>'

    • 要调试套件中的所有测试,请点击套件旁边标记栏中的 运行测试图标 ,然后在列表中选择 调试 '<测试套件名称>'

      TypeScript 测试:从编辑器调试测试套件
    • 或者,创建类型为 Node.js 测试运行器 的运行/调试配置, 如上所述 ,从 运行 小部件中选择它,并点击其旁边的 调试图标

      TypeScript 测试:通过运行/调试配置调试测试
最后修改日期: 2025年 12月 2日