如何在NX Monorepo中配置affected命令以忽略测试专用库的变更？

算力阿峰

2026-4-28

当然可以实现！我之前维护类似的Angular/NestJS monorepo时刚好碰到过完全一样的需求，下面给你两种可行的方案，从快速配置到精细控制都覆盖到了：

方案1：利用NX Tags快速排除测试库本身（基础版）

如果你的核心需求只是不想让测试库本身被affected命令纳入执行范围，同时保留“修改旧函数时标记依赖业务库”的逻辑，可以用NX的标签系统实现：

给两个测试库打上专属标签
在每个测试库的project.json文件中，添加tags字段标记它们为测试工具类库：
```
{
  "name": "testing-angular",
  // ... 其他配置
  "tags": ["type:test-utils"]
}
```
另一个NestJS测试库也做同样的配置。
修改NX全局配置排除标签
在工作根目录的nx.json中，找到tasksRunnerOptions.default.options，添加affected.exclude规则：
```
{
  "tasksRunnerOptions": {
    "default": {
      "options": {
        "affected": {
          "exclude": ["**/*type:test-utils*"]
        }
      }
    }
  }
}
```
这样配置后，affected命令会自动排除测试库本身的执行，但如果测试库中旧函数被修改，依赖它的业务库依然会被正常标记为受影响——因为NX会追踪依赖关系的代码变更，而不是只看标签。

方案2：自定义脚本区分“新增/修改”变更（精准满足需求）

如果你的核心需求是只有测试库的旧代码被修改时才标记依赖业务库，新增辅助函数时完全忽略，就需要结合Git Diff和NX的--files参数来实现精细控制：

编写自定义过滤脚本
在项目根目录创建scripts/affected-smart-test.sh脚本（用bash示例）：

#!/bin/bash

# 定义测试库的目录路径
TEST_LIBS=("libs/testing-angular" "libs/testing-nestjs")

# 获取Git中被修改（非纯新增）的测试库文件：过滤掉新增文件，只保留修改/修改+新增的文件
MODIFIED_FILES=$(git diff --name-status HEAD~1 | \
  grep -E '^(M|AM)' | \
  grep -E "$(IFS="|"; echo "${TEST_LIBS[*]}")" | \
  awk '{print $2}')

# 根据文件变更情况执行不同的affected命令
if [ -n "$MODIFIED_FILES" ]; then
  # 如果有旧代码被修改，基于这些变更文件计算受影响项目
  npx nx affected:test --files="$MODIFIED_FILES"
else
  # 如果只有新增内容，排除测试库的变更，不标记依赖业务库
  npx nx affected:test --exclude="type:test-utils"
fi

添加快捷执行脚本
在根目录的package.json中添加一个脚本入口，方便开发者使用：
```
{
  "scripts": {
    "affected:test:smart": "./scripts/affected-smart-test.sh"
  }
}
```
之后开发者只需要运行npm run affected:test:smart，就能实现你想要的逻辑：新增测试函数时不会触发业务库的测试，修改旧函数时正常标记依赖库。

补充说明

如果你的测试库导出都集中在index.ts文件中，可以进一步优化脚本：只监控index.ts的变更是否修改了现有导出（而不是新增导出），这样控制会更精准——比如用Git Diff检查index.ts的变更是否只有新增的export语句，没有修改现有行。

内容的提问来源于stack exchange，提问作者distante

如何在NX Monorepo中配置affected命令以忽略测试专用库的变更？

补充说明 #

补充说明