什么是TypeScript映射文件?
参考答案
两种"映射文件"
**1. Source Map(源码映射文件 .js.map)** —— 最常被问到的那个。
- 作用:把编译/压缩后的代码位置映射回原始源码位置,让浏览器 DevTools 能显示 TS 源码并正确断点。
- 开启:
"sourceMap": true(或inlineSourceMap把 map 内嵌成 base64,sourceMap+mapRoot控制路径)。 - 结构:
{ version, sources, sourcesContent, names, mappings(VLQ 编码) }。 - 配合
"inlineSources": true可把源码内容写进 map,发布时不必带.ts文件。 - 生产建议:保留 map 但不公开(上传到监控平台如 Sentry),或关闭以免泄露源码。
**2. 声明映射 / 声明文件(.d.ts)**
- 开启
"declaration": true生成.d.ts,描述模块对外暴露的类型,供使用方获得类型提示。 "declarationMap": true生成.d.ts.map,让"跳转到定义"能定位回原始.ts源码而不是.d.ts。- 发布库时的
types/typings字段指向入口.d.ts。
其他相关
- 路径映射:
baseUrl+paths把别名映射到真实目录(严格说不是"映射文件",但常一起被问)。 - **
resolveJsonModule** 允许 import JSON。 - **
typeRoots/types** 控制@types的查找。
要点
.map 文件不参与运行,只是调试辅助;.d.ts 不参与运行,只是类型信息。两者都不含实现代码。