Jest无法定位别名模块@myPackage/button 配置问题求助

从你的报错信息和配置来看，核心问题出在jest.config.js的moduleNameMapper配置错误，还有路径映射逻辑的偏差，下面是具体修复步骤：

1. 移除moduleNameMapper中的无效配置项 #

你的moduleNameMapper里混入了不属于该配置的prefix属性，这会干扰Jest解析配置规则，直接删除这一行：

module.exports = {
  preset: 'ts-jest',
  moduleFileExtensions: ['js', 'json', 'jsx', 'ts', 'tsx', 'node'],
  moduleDirectories: ["node_modules", "./"],
  moduleNameMapper: {
    "^@myPackage/(.*)$": "<rootDir>/node_modules/@myPackage/$1",
    "^lib/(.*)$": "<rootDir>/lib/$1"
    // 删除此行：prefix: '<rootDir>/src',
  },
};

2. 简化@myPackage的映射（针对已安装的npm包） #

如果@myPackage/button是通过npm/yarn安装在node_modules里的第三方包，根本不需要额外配置moduleNameMapper——你的moduleDirectories已经包含node_modules，Jest会自动到该目录查找模块。直接删掉^@myPackage/(.*)$这行映射，让Jest默认解析：

moduleNameMapper: {
  "^lib/(.*)$": "<rootDir>/lib/$1"
},

3. 适配本地自定义包场景（如monorepo或link包） #

如果@myPackage是你本地开发的自定义包（比如项目内的子包，或通过npm link关联的本地包），需要修正映射路径：

• 假设本地包的实际路径是<rootDir>/packages/@myPackage，映射规则应改为：

"^@myPackage/(.*)$": "<rootDir>/packages/@myPackage/$1"

• 同步TypeScript路径配置：VS Code能跳转说明tsconfig.json的paths是正确的，可借助tsconfig-paths-jest插件让Jest复用该配置：
  先安装插件：

  npm install --save-dev tsconfig-paths-jest
  

  再修改jest.config.js：

  const tsconfig = require('./tsconfig.json');
  const moduleNameMapper = require('tsconfig-paths-jest')(tsconfig);
  
  module.exports = {
    // ...其他配置
    moduleNameMapper: {
      ...moduleNameMapper,
      "^lib/(.*)$": "<rootDir>/lib/$1"
    },
  };
  

4. 清理Jest缓存 #

配置修改后，清理缓存确保新规则生效：

npx jest --clearCache

验证修复 #

重新运行测试，检查模块找不到的错误是否消失。若问题仍存在，确认node_modules/@myPackage/button是否真实存在，且路径与报错信息一致（Windows路径建议用正斜杠避免转义问题）。

报错信息参考：

Could not locate module @myPackage/button mapped as:

Systempath\projectpath\node_modules\@myPackage\button

Please check your configuration for these entries:
{
  "moduleNameMapper": {
    "/^@myPackage\/(.*)$/": "Systempath\projectpath\node_modules\@myPackage\button\$1"
  },
  "resolver": null
}

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