sourceMap 匹配调试

为方便开发者使用sourceMap文件定位代码问题,增加调试器插件优化sourceMap匹配调试。

运行环境

  • 下载并安装 1.03.2012152 或以上版本的开发者工具,下载地址

下载流程

打开微信开发者工具,在菜单栏选择"设置-通用设置-扩展-调试器插件",进入插件下载页面,添加sourcemap匹配调试插件。添加成功后,即可在调试器使用该插件。

使用流程

  1. 下载sourceMap文件(可在mp后台或开发者工具上传成功弹窗下载)
  2. 找到发生错误对应的分包,选择分包的map文件
  3. 填入目标行列号,点击“匹配按钮” 即可获得匹配结果,并自动定位源代码位置。(开发者工具会按照源行列号,自动定位代码对应位置。若要保证定位准确,开发者需要自行保证代码版本与sourceMap文件相匹配) 显示如下: 显示

sourcemap 的目录和文件说明

  1. APP 是主包,FULL 是整包(仅在不支持分包的低版本微信中使用),其他目录是分包。
  2. 每个分包下都有对应的 app-service.js.map 文件。
  3. 如果是使用了按需注入特性(app.json中配置了lazyCodeLoading),那么每个分包下还会有 appservice.app.js.map(对应分包下非页面的js),和所有页面的 xxx.js.map。

Q&A

Q: 为啥都是 null?

A: 每个小程序版本都应该对应一个sourcemap文件。 运营中心那里下载的 sourcemap 是对应线上最新的小程序版本。但运营中心的报错集合了多个小程序版本。拿旧小程序版本的报错信息,和最新版本的 sourcemap,是匹配不出的。开发者工具和ci 上传的时候,会提示下载对应版本的 sourcemap 信息,可以自助保存。 mp

Q: 怎么确定有没有版本对应上

A: 下载的 sourcemap 中有个 wx 字段,标明了该 sourcemap 文件对应小程序版本号。 wx mp_detail