Monorepo中Jest配置如何指定根目录node_modules映射依赖？

针对Monorepo中Jest模块映射无法指向根目录node_modules的问题，推荐以下两种无需修改rootDir的优雅方案：

方案1：利用require.resolve()自动定位依赖路径 #

Monorepo中依赖通常会被hoist到根目录的node_modules，Node.js的require.resolve()会遵循模块解析规则从当前目录向上查找，自动定位到包的实际位置。直接在子包的jest.config.js中替换映射规则：

const baseConfig = require('../../jest.base.config');

module.exports = {
  ...baseConfig,
  moduleNameMapper: {
    ...(baseConfig.moduleNameMapper || {}), // 继承基础配置中的映射规则
    '^.+\\.svg$': '<rootDir>/__mocks__/mockSVG.js',
    '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga|pdf)$':
      '<rootDir>/__mocks__/mockFile.js',
    '\\.(css|less)$': 'identity-obj-proxy',
    // 替换为require.resolve生成的正确路径
    '@uiw/react-textarea-code-editor': require.resolve('@uiw/react-textarea-code-editor/dist/editor.js'),
  },
  // 其他原有配置...
};

这种方法完全依赖Node的原生模块解析机制，无需硬编码路径，适配性最强。

方案2：通过绝对路径拼接根目录 #

如果偏好显式指定路径，可以用path.resolve()结合子包的__dirname生成Monorepo根目录的绝对路径，再拼接依赖位置：

const baseConfig = require('../../jest.base.config');
const path = require('path');

// 从子包目录向上两级定位到Monorepo根目录
const monorepoRoot = path.resolve(__dirname, '../../');

module.exports = {
  ...baseConfig,
  moduleNameMapper: {
    ...(baseConfig.moduleNameMapper || {}),
    '^.+\\.svg$': '<rootDir>/__mocks__/mockSVG.js',
    '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga|pdf)$':
      '<rootDir>/__mocks__/mockFile.js',
    '\\.(css|less)$': 'identity-obj-proxy',
    // 用绝对路径指向根目录的依赖文件
    '@uiw/react-textarea-code-editor': path.join(monorepoRoot, 'node_modules/@uiw/react-textarea-code-editor/dist/editor.js'),
  },
  // 其他原有配置...
};

为什么之前的相对路径会报错？ #

Jest处理moduleNameMapper中的相对路径时，会基于当前运行Jest的工作目录解析（比如在子包目录运行时工作目录是子包根目录，在Monorepo根目录运行时则是根目录），硬编码的相对路径无法适配不同运行场景，而上述两种方案都避免了这个问题。

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