name: nx-run-tasks description: 帮助在 Nx 工作空间中运行任务。当用户想要执行构建、测试、lint、服务或运行工作空间中定义的任何其他任务时使用。

您可以通过以下方式使用 Nx 运行任务。

请注意，如果用户没有全局安装 nx，可能需要使用 npx/pnpx/yarn 前缀。查看 package.json 或 lockfile 以确定使用的包管理器。

有关任何命令的更多详细信息，请使用 --help 运行它（例如 nx run-many --help、nx affected --help）。

了解可以运行哪些任务

您可以通过 nx show project <项目名称> --json 检查，例如 nx show project myapp --json。它包含一个 targets 部分，其中包含有关可运行目标的信息。您也可以直接查看 package.json 脚本或 project.json 目标，但可能会错过 Nx 插件推断的任务。

运行单个任务

nx run <项目>:<任务>

其中 项目 是在 package.json 或 project.json（如果存在）中定义的项目名称。

运行多个任务

nx run-many -t build test lint typecheck

您可以传递 -p 标志以过滤到特定项目，否则在所有项目上运行。您还可以使用 --exclude 排除项目，以及使用 --parallel 控制并行进程的数量（默认为 3）。

示例：

nx run-many -t test -p proj1 proj2 — 测试特定项目
nx run-many -t test --projects=*-app --exclude=excluded-app — 测试匹配模式的项目
nx run-many -t test --projects=tag:api-* — 按标签测试项目

为受影响的项目运行任务

使用 nx affected 仅对已更改的项目以及依赖于更改项目的项目运行任务。这在 CI 和大型工作空间中尤其有用。

nx affected -t build test lint

默认情况下，它与基础分支进行比较。您可以自定义此设置：

nx affected -t test --base=main --head=HEAD — 与特定的基和头进行比较
nx affected -t test --files=libs/mylib/src/index.ts — 直接指定更改的文件

有用的标志

这些标志适用于 run、run-many 和 affected：

--skipNxCache — 即使结果已缓存也重新运行任务
--verbose — 打印额外信息，如堆栈跟踪
--nxBail — 在第一个任务失败后停止执行
--configuration=<名称> — 使用特定配置（例如 production）