nx-run-tasks

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

请注意，如果用户没有全局安装 nx，你可能需要在命令前加上 npx/pnpx/yarn。查看 package.json 或锁文件，确定正在使用哪个包管理器。

如需了解任何命令的详细信息，请使用 --help 运行该命令（例如，nx run-many --help、nx affected --help）。

了解可以运行哪些任务

你可以通过 nx show project <projectname> --json 查看，例如 nx show project myapp --json。其中包含一个 targets 部分，提供了可运行目标的信息。你也可以查看 package.json 脚本或 project.json 中的目标，但可能会遗漏 Nx 插件推断出的任务。

运行单个任务

nx run <project>:<task>

其中，project 是 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=<name> — 使用指定配置（例如，production）