WebStorm 2025.2 Help

Nx

WebStorm 集成了专为 mono 仓库优化的 Nx 构建系统,具备内建的代码脚手架、模块边界强制、自动更新,以及支持缓存与分发的高级 CI 功能。

WebStorm 为您提供了一个专用的 Nx 控制台 工具窗口以及一个 Nx 运行/调试配置,用于运行和调试脚本。

如果您使用 Karma 进行测试,亦可在 Karma 运行/调试配置中将 Nx 包指定为 Karma 包。

开始之前

  1. 请确保您的计算机上已安装 Node.js

  2. 设置 | 插件 页的 Marketplace 选项卡中安装并启用 Nx Console 插件,相关说明请参见 从 JetBrains Marketplace 安装插件

创建 NX 工作区

  1. 欢迎 界面上点击 新建项目 ,或从主菜单中选择 文件 | 新建 | 项目。 将打开 新建 项目 对话框

  2. 在左侧窗格中,选择 Nx

  3. 在右侧窗格中:

    • 指定与项目相关文件将被存储在的文件夹路径。

    • Node 解释器 字段中,指定要使用的 Node.js 解释器。 从列表中选择一个已配置的解释器,或点击 添加 来配置新的解释器。

    • 命令 列表中选择 npx create-nx-workspace @latest

    创建 Nx 工作区
  4. 点击 创建 并回答向导中的问题。 根据回答,将创建并设置一个工作区。

    向导中的问题已回答。 正在生成 Nx 工作区
  5. 点击链接以转到授权页面。

    授权链接

Nx 控制台工具窗口

Nx 控制台 工具窗口提供有关工作区的信息。 该窗口列出了您的所有项目以及可为其运行的目标,例如 buildservetestlint ,以及您设置的任何配置。

在目标的上下文菜单中,您可以运行或调试该目标,也可以编辑其专用的运行/调试配置。

Nx 控制台工具窗口
  1. 要打开 Nx 控制台 工具窗口,请单击侧边栏中的

    Nx 控制台工具窗口栏
    ,或转到主菜单中的 视图 | 工具窗口 | Nx 控制台

  2. 要查看显示的项目和目标列表,请单击 刷新工作区 ,或单击工具窗口工具栏中的 Reload Nx Projects 图标

    刷新工作区

运行和调试 Nx 目标

您可以通过 Nx 控制台 工具窗口或专用的 Nx 运行/调试配置来运行和调试 Nx 目标。

运行目标

  • Nx 控制台 工具窗口中,选择一个目标,然后从其上下文菜单中选择 运行 '<target_name>'

    Nx 工具窗口:运行目标
  • 在工具栏的 运行 部件中,选择包含目标名称的配置,然后单击其旁边的 运行图标

    通过运行/调试配置运行目标

调试目标

  1. 在脚本中必要位置设置断点。

  2. Nx 控制台 工具窗口中,选择一个目标,然后从其上下文菜单中选择 调试 '<target_name>'

    Nx 工具窗口:调试目标

    或者,在工具栏中的 运行 部件中,选择包含目标名称的配置,然后单击其旁边的 调试图标

    通过运行/调试配置调试目标

为目标编辑运行/调试配置

  1. 请选择以下操作之一:

    • Nx 控制台 工具窗口中,选择一个目标,然后从其上下文菜单中选择 编辑 '<target_name>

      Nx 控制台工具窗口:编辑运行/调试配置
    • 在主工具栏的 运行 部件中选择 编辑配置 ,然后从列表中选择相应的配置。

      编辑运行/调试配置 - 运行部件

    编辑运行/调试配置:<target name> 对话框将打开。

  2. 更新默认的自动生成设置并保存运行/调试配置。

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