如何将TypeScript路径别名转换为Jest的moduleNameMapper（含单文件别名）

别担心，这事儿其实很简单，我来给你拆解清楚怎么配置Jest的moduleNameMapper来匹配你tsconfig里的所有别名，包括那个单文件的映射。

首先，Jest的moduleNameMapper是通过正则表达式来匹配别名的，我们需要针对每个别名写对应的规则：

完整的Jest配置示例 #

假设你的Jest配置文件是jest.config.ts，可以这么写：

export default {
  // 其他基础配置（比如testEnvironment、testMatch等）
  testEnvironment: 'node',
  testMatch: ['**/__tests__/**/*.ts', '**/?(*.)+(spec|test).ts'],
  
  // 核心的路径别名映射
  moduleNameMapper: {
    // 匹配@eddystone-shared/*，映射到父目录的shared文件夹
    '^@eddystone-shared/(.*)$': '<rootDir>/../shared/$1',
    // 匹配@eddystone-firebase-helpers/*，映射到src下的对应子目录
    '^@eddystone-firebase-helpers/(.*)$': '<rootDir>/src/helpers/firebase-helpers/$1',
    // 精确匹配单文件别名@eddystone-func-config，映射到指定文件
    '^@eddystone-func-config$': '<rootDir>/src/config/config',
  },

  // 处理TypeScript文件的转译
  transform: {
    '^.+\\.tsx?$': 'ts-jest',
  },

  // 确保Jest能识别你的文件扩展名
  moduleFileExtensions: ['ts', 'js', 'json'],
};

关键细节解释 #

• <rootDir>是Jest内置的变量，指向你的项目根目录（也就是tsconfig.json所在的目录），用它来写路径更灵活，避免硬编码相对路径。
• 对于单文件别名@eddystone-func-config，我们用正则^@eddystone-func-config$——^和$是正则的开始和结束标记，这样只会精确匹配这个别名本身，不会误匹配到类似@eddystone-func-config/xxx的路径（当然你这里也没有这种情况，但是加上更严谨）。
• 另外别忘了确保你已经安装了必要的依赖：ts-jest和@types/jest，如果还没装的话，执行：

npm install --save-dev ts-jest @types/jest

如果你的Jest配置是用.js格式的，只需要把导出方式改成module.exports就行，其他规则完全一致。

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