为何Jest的globalSetup在部分项目调用场景下不执行？

问题场景 #

我维护一个使用Jest的TypeScript monorepo，目录结构如下：

packages
|-package1
| |- test1.test.ts
|-package2
| |- test2.test.ts
jest.config.ts
jest.globalSetup.ts

根目录的jest.config.ts配置了多项目模式与全局启动脚本，用于初始化所有测试依赖的共享本地数据库：

import { Config } from "jest";

const jestConfig: Config = {
  projects: [
    "<rootDir>/packages/package1",
    "<rootDir>/packages/package2"
  ],
  globalSetup: "<rootDir>/jest.globalSetup.ts",
};

export default jestConfig;

jest.globalSetup.ts仅做日志输出验证执行情况：

export default function globalSetup() {
  console.log("🌏");
}

但不同测试命令下，globalSetup的执行情况不一致：

• jest：触发globalSetup
• jest packages/package1：触发globalSetup
• jest --projects packages/package1：不触发globalSetup
• cd packages/package1 && jest：不触发globalSetup

原因解析 #

Jest的globalSetup执行逻辑完全依赖配置加载的上下文，不同命令对应不同的配置加载行为：

1. jest：加载根目录的多项目配置，根配置的globalSetup作为全局钩子，在所有子项目测试启动前执行一次。
2. jest packages/package1：指定单个测试目录时，Jest仍优先加载根配置，将目标目录作为根多项目配置的子集处理，因此会执行根配置的globalSetup。
3. jest --projects packages/package1：--projects参数会让Jest直接加载指定项目的配置（无项目配置则用默认），跳过根配置的全局钩子逻辑——此时Jest认为你要单独运行该项目，而非在根多项目上下文下运行。
4. cd packages/package1 && jest：在子目录运行时，Jest优先读取子目录的jest配置（无配置则用默认），完全不加载根目录的配置，因此根配置的globalSetup不会执行。

解决方案 #

方案1：子项目配置继承根配置 #

给每个子项目添加jest.config.ts，通过extends继承根配置，确保所有场景都加载根级的globalSetup：

// packages/package1/jest.config.ts
import type { Config } from 'jest';

const config: Config = {
  extends: '../../jest.config.ts',
  // 子项目专属配置（如testMatch、moduleNameMapper等）
};

export default config;

此方案下，无论用--projects指定单个项目，还是在子目录直接运行jest，都会继承根配置的globalSetup，且根配置的globalSetup仅执行一次（符合共享数据库的需求）。

方案2：强制指定根配置运行 #

在需要单独运行子项目时，通过--config参数强制加载根配置：

# 在子目录运行时
jest --config ../jest.config.ts

# 指定单个项目时
jest --config jest.config.ts --projects packages/package1

此方案适合CI脚本等固定命令场景，但需要手动指定参数，不够灵活。

方案3：区分场景使用（按需选择） #

如果仅需在批量测试所有项目时启动共享数据库，单个项目测试无需依赖，则当前行为符合预期——此时无需修改配置，仅在批量测试时使用根配置即可。

内容的提问来源于stack exchange，提问作者jon without an h