TypeScript Jest导入带.js扩展名报错：无法找到模块

问题分析 #

你的TypeScript配置启用了moduleResolution: nodenext，这要求导入语句必须显式添加.js扩展名（因为TS编译后会生成.js文件，Node.js的ES模块规范要求显式扩展名）。项目运行时一切正常，但Jest测试时会按导入的.js路径查找文件，而实际源文件是.ts格式，导致出现模块找不到的错误；但如果把导入的.js改成.ts，又会触发TypeScript本身的编译错误。

解决方案 #

1. 安装必要依赖 #

选择以下任意一种转译工具（推荐@swc/jest，转译速度更快）：

• 使用ts-jest：

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

• 使用swc：

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

2. 配置Jest规则 #

创建或修改项目根目录下的jest.config.js文件：

/** @type {import('jest').Config} */
const config = {
  preset: 'ts-jest', // 若用swc则替换为 '@swc/jest'
  testEnvironment: 'node',
  // 把导入路径中的.js后缀映射到同名的.ts文件
  moduleNameMapper: {
    '^(\\.{1,2}/.*)\\.js$': '$1'
  },
  // 告知Jest将.ts文件视为ES模块处理
  extensionsToTreatAsEsm: ['.ts'],
  moduleFileExtensions: ['ts', 'js', 'json'],
  transform: {
    // ts-jest专属配置，使用swc可忽略此段
    '^.+\\.tsx?$': ['ts-jest', {
      useESM: true
    }]
  }
};

module.exports = config;

3. 验证效果 #

保持原有导入写法不变（例如import ServerError from '../models/Errors/ServerError.js'），重新运行Jest测试即可。此时Jest会通过moduleNameMapper自动将.js后缀的导入指向对应的.ts源文件，同时TypeScript编译时依然能正确识别.js作为编译后的目标文件扩展名，兼顾了运行和测试的需求。

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