Jest 中开启 SourceMap 旨在让测试报错时准确定位原始 TypeScript 或编译后源码位置；默认已启用，需确保 tsconfig.json 或 Babel 配置 sourceMap、ts-jest 正确配置且未被 transform 覆盖。
在 Jest 中开启 SourceMap 主要是为了让测试报错时能准确定位到原始 TypeScript 或编译后（如 Babel、Webpack）的源代码位置，而不是转译后的 JS 文件。Jest 默认已启用 SourceMap 支持，但需确保构建工具和测试配置协同工作。
确保 TypeScript 或 Babel 正确生成 SourceMap
SourceMap 的源头不在 Jest，而在你的构建步骤：
-
TypeScript：在 tsconfig.json 中设置
"sourceMap": true，并推荐同时开启"inlineSources": true（将源码嵌入 SourceMap，方便 Jest 直接读取） -
Babel：在 babel.config.js 或 .babelrc 中添加
sourceMaps: true（Jest 默认会传递该选项；若手动调用@babel/register，需显式配置） - 使用 Webpack 构建测试入口？Jest 一般不走 Webpack 执行测试——除非你用
jest-webpack等插件，此时需确保 Webpack 的devtool: 'source-map'生效且 SourceMap 输出到输出目录
Jest 配置无需额外开启，但需避免干扰
Jest 默认自动识别并使用 .map 文件，只要源文件与 SourceMap 同目录或路径可解析即可。注意以下几点：
- 不要在 jest.config.js 中设置
transform: {}覆盖默认行为，除非你自定义了 transformer——此时需确保你的 transformer 返回结果包含map字段（例如return { code, map }） - 若用
ts-jest，它默认启用 SourceMap；确认版本 ≥ 29，并检查 jest.config.js 中transform正确引用：'^.+\.tsx?$': 'ts-jest' - 禁用缓存调试时加
--no-cache，防止旧的无 SourceMap 缓存干扰
验证 SourceMap 是否生效
运行一个故意出错的测试（比如 expect(1).toBe(2)），观察错误堆栈：
- ✅ 正确表现：堆栈中显示
src/utils.ts:12:5或src/sum.test.ts:8等原始路径和行号 - ❌ 失效表现：只显示
/path/to/project/packages/utils.js:45:10（编译后路径）、或行号明显偏移、或提示Source map not loaded - 可在 Node.js 调试模式下（
node --inspect-brk node_modules/.bin/jest --runInBand）配合 Chrome DevTools 查看 “Sources” 面板是否列出webpack://或file://下的源文件
常见问题速查
-
用了 pnpm/yarn v4+？ 某些链接方式可能导致
node_modules内部模块 SourceMap 解析失败，尝试在 jest.config.js 中加modulePaths: ['或调整'] moduleNameMapper -
测试跑在 CI 上没映射？ 检查 CI 环境是否删掉了
.map文件（如git clean -fdx或构建脚本误删），确保dist/**.map被保留 -
VS Code 调试断点不命中？ 在 .vscode/launch.json 中启用
"sourceMaps": true，并确认"outFiles"匹配实际输出路径（如["${workspaceFolder}/dist/**/*.js"]）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
