Yarn v1嵌套工作区安装jest版本错误如何解决

Yarn v1 未实现完整的嵌套工作区支持，依赖提升（hoist）逻辑存在设计缺陷：遍历嵌套工作区依赖时，不会将嵌套子包视为独立的依赖边界，只要父级目录路径上的任意node_modules中存在符合semver范围的对应包（包括其他依赖引入的传递依赖），就会直接将子包依赖软链到该版本，忽略子包自身package.json中声明的版本号。在pkgA中添加jest声明未生效，本质是未清理旧安装缓存与软链，且Yarn v1的提升逻辑不会主动修正已存在的错误软链。

按推荐优先级从高到低排列：

方案1：使用官方nohoist规则隔离依赖（非hack，官方支持） #

Yarn v1 提供了nohoist配置，可精准阻止指定依赖被提升到上层目录，从安装层面解决版本错配问题。

• 修改根目录package.json的workspaces配置，添加针对subPkgA1下jest的隔离规则：

"workspaces": {
  "packages": [
    "packages/pkgA",
    "packages/pkgA/subPkgA1",
    "packages/pkgB"
  ],
  "nohoist": [
    "**/subPkgA1/jest",
    "**/subPkgA1/jest/**"
  ]
}

规则说明：第一条匹配subPkgA1的直接依赖jest本身，第二条匹配jest的所有内部传递依赖，避免jest内部依赖被提升导致的版本冲突。如果路径匹配不稳定，也可以替换为subPkgA1的实际包名，例如"**/@your-scope/sub-pkg-a1/jest"，匹配精度更高。

• 全量清理旧的安装产物与缓存，避免旧软链干扰：

# 删除所有层级的node_modules
rm -rf node_modules packages/pkgA/node_modules packages/pkgA/subPkgA1/node_modules packages/pkgB/node_modules
# 清理jest相关的yarn缓存
yarn cache clean jest
# 重新安装依赖
yarn install

安装完成后subPkgA1的node_modules下会保留独立的jest@27.4.7，不会被上层的24.9.0版本覆盖。

方案2：postinstall脚本强制修正（临时hack方案，100%生效） #

如果nohoist规则因为项目中其他依赖的干扰无法生效，可以用安装后脚本绕开Yarn的提升逻辑，强制修正版本：

• 在packages/pkgA/subPkgA1/package.json中添加postinstall钩子：

"scripts": {
  "postinstall": "node ./fix-jest-version.js"
}

• 在subPkgA1根目录新建fix-jest-version.js文件，内容如下：

const path = require('path');
const fs = require('fs');
const { execSync } = require('child_process');

const TARGET_JEST_VERSION = '27.4.7';
const subPkgRoot = __dirname;
const jestPkgPath = path.join(subPkgRoot, 'node_modules/jest');
const jestBinPath = path.join(subPkgRoot, 'node_modules/.bin/jest');

// 校验当前已安装的jest版本
let installedVersion = null;
try {
  installedVersion = require(path.join(jestPkgPath, 'package.json')).version;
} catch (err) {}

if (installedVersion !== TARGET_JEST_VERSION) {
  // 清除错误的安装产物
  fs.rmSync(jestPkgPath, { recursive: true, force: true });
  fs.rmSync(jestBinPath, { force: true });
  // 强制在当前子包目录下安装目标版本jest，禁止提升
  execSync(`yarn add jest@${TARGET_JEST_VERSION} --force --no-hoist`, {
    cwd: subPkgRoot,
    stdio: 'inherit'
  });
}

后续每次执行yarn install后，脚本会自动校验jest版本，不符合要求就强制重装正确版本。

执行subPkgA1下的jest命令时，不要直接在pkgA目录下运行，避免PATH优先级问题加载到上层的jest 24.9.0：

• 进入subPkgA1目录后执行yarn jest
• 在项目根目录执行yarn workspace <subPkgA1的实际包名> jest

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