3-7 sourceMap的配置

1. 简介

sourceMap,顾名思义,就是对源文件的映射。比如打包压缩后的代码对应源文件中的哪一行代码,这能够极大地方便开发者的调试。

2. sourceMap的作用

我们用一个简单的示例,来看一下sourceMap的作用。如图,先精简一下之前的项目文件。


image.png

将sidebar.js中的console,log故意携程console.lo,修改webpack_config.js如下:

// webpack.config.js
var HtmlWebpackPlugin = require('html-webpack-plugin');
var { CleanWebpackPlugin } = require('clean-webpack-plugin');
var path = require('path');

module.exports = {
    entry: {
        index: "./src/index.js",
    },
    devtool: "none",
    output: {
        path: path.resolve(__dirname, 'dist'),
        filename: "[name].js"
    },
    mode: 'development',
    plugins: [new HtmlWebpackPlugin({
        template: "./src/index.html"
    }), new CleanWebpackPlugin()]
};

打包后打开index.html,我们发现网页上没有sidebar。打开调试模式有报错。


image.png

点击报错提示,我可以看到光标直接在出问题的代码处闪烁。但问题是,我们并不是直接修改打包后的文件来修复问题,而是去修改源文件来解决问题。所以,我们希望能够直接定位到出错的源代码。

3. source map

source map是用来记录转换后代码和源代码之间映射关系的代码,当客户端浏览器在收到打包后的js文件时,它根据指定的sourcmap文件把打包的的js代码转换成格式规范的js代码。
也就是说,浏览器运行转换后的代码出错时定位到源代码位置的关键因素在于:
有记录映射关系的source_map,并能告知浏览器如何读取。
我们配置如下属性:

devtool: "source-map"

运行打包命令后,如下:


image.png

image.png

生成了一个单独的source map文件用来记录映射关系,同时在打包生成的代码末尾注明了source map文件的地址。
点击报错信息,如下,点击后直接定位到了出错的源码。


image.png

总结:整个 source map 作为一个单独的文件生成。它为 bundle 添加了一个引用注释,以便开发工具知道在哪里可以找到它。可用于生产环境和开发环境。对于生产环境,应该将服务器配置为,不允许普通用户访问 source map 文件。
优点:能够准确映射到原始源代码
缺点:由于携带了最完整的映射信息,所以构建和重构速度很慢

我们目前使用的是生成一个完整的map文件的形式来记录映射信息,那么还有没有别的方法呢?

3.1 inine 关键字

顾名思义,内联。就是将.map文件作为DataURI嵌入,不单独生成.map文件。他必须与其它关键字配合使用,如下:

devtool: "inline-source-map"

打包后如下:


image.png

可以看到没有map文件了,底部的 sourceMappingURL 从文件地址变成了base64编码。等于是将原来单独的map文件编码城base64内嵌到了打包输出的js文件中。
点击报错信息后直接定位到了出错的源码。
总结: source map 转换为 DataUrl 后添加到 bundle 中。仅用于开发环境
优点:能够准确映射到原始源代码,相较source-map,可以少加载一个文件
缺点:由于携带了最完整的映射信息,所以构建和重构速度很慢。相较source-map,打包后的index.js文件变大了。

3.2 hidden 关键字

隐藏源文件。仅有一种搭配:

devtool: "hidden-source-map"

打包后如下:


image.png

没有引用地址注释了,但仍然可以准确定位到源文件信息。


image.png

总结:与 source-map 相同,但不会为 bundle 添加引用注释。如果你只想 source map 映射那些源自错误报告的错误堆栈跟踪信息,但不想为浏览器开发工具暴露你的 source map,这个选项会很有用。可用于开发环境和生产环境。生产环境中,不应将 source map 文件部署到 web 服务器。而是只将其用于错误报告工具。
ps:inline可以和大多数关键字配合使用,作用是将source map进行内联。

3.3 eval 关键字

直接将每个模块使用 eval 执行。这里可以单独使用,也可以搭配其他关键字使用。

3.3.1 eval

devtool: "eval"
image.png

image.png

总结:每个模块都使用 eval() 执行,并且都有 //@ sourceURL。仅用于开发环境。
优点:此选项会非常快地构建。
缺点:由于会映射到转换后的代码,而不是映射到原始代码(没有从 loader 中获取 source map),所以不能正确地显示行数。

3.3.2 eval-source-map

devtool: "eval-source-map"
image.png

image.png

总结:每个模块使用 eval() 执行,并且 source map 转换为 DataUrl 后添加到 eval() 中。仅用于开发环境。
优点:重新构建时有比较快的速度,并且生成实际的文件。行数能够正确映射,因为会映射到原始代码中。它会生成用于开发环境的最佳品质的 source map。
缺点:初始化 source map 时比较慢

3.3.3 搭配其他关键字

eval 还可以搭配其他关键字,下面会讲到。但不管搭配什么,它的作用都是,将每个模块都使用 eval() 执行。

4. source map详细程度

目前为止,我们都是拿到了所有模块的完整映射信息。但是,十几条是的时候我们并不需要这么晚完整的映射信息。那么有什么办法来减少不必要的映射信息,加快构建速度呢?

4.1 cheap 关键字

作用: 顾名思义,低配的。不包含列信息,也不包含loader的sourcemap。可搭配大部分其他关键字使用。比如:

devtool: "cheap-source-map"

sourceMap文件默认会保存打包代码和源代码之间的行与列的映射信息,文件内容较复杂时,报错会携带列信息。但如果指明了cheap,就不需要映射列信息,出错时只会携带行信息。另外,不包含loader的 sourcemap(例如 babel 的 sourcemap)。


image.png

image.png

如图,仅定位到了错误的行。
总结:没有列映射(column mapping)的 source map,忽略 loader source map。映射的是转换过的代码(仅限行)。可用于开发环境和生产环境。
优点:构建速度较快。
缺点:映射信息品质降低。

4.2 module 关键字

module关键字仅在 cheap 关键字存在的情况下使用。用来提升映射信息品质,输出模块映射的行信息。

devtool: "cheap-module-source-map"
image.png

image.png

总结:没有列映射(column mapping)的 source map,将 loader source map 简化为每行一个映射(mapping)。可用于开发环境和生产环境。
优点:提升了映射信息品质,映射到原始源代码(仅限行)。
缺点:品质和速度都是中等,并无突出的地方。

5. 最佳模式

以上关键字,都拥有自己的行为,搭配起来,就是将不同的行为进行组合。

  1. source-map 生成映射信息文件
  2. inline 将映射信息内联
  3. eval 将模块用eval包裹执行。含有这个关键字就不能用于生产环境。
  4. cheap 降低映射信息品质,没有列信息,没有loader的映射信息
  5. module 必须与cheap搭配,仍然没有列信息,但是会映射loader的行信息
    基于以上特征,我们在生产和开发中的最佳搭配模式如下:
    开发:cheap-module-eval-source-map
    生产:cheap-module-source-map

补充

原理后续研究一下。

参考

https://www.webpackjs.com/configuration/devtool/
https://webpack.js.org/configuration/devtool/
Webpack中的sourcemap
MDN - 使用 source map
解决Failed to parse SourceMap: http:xxx 问题
浅谈webpack devtool里的7种SourceMap模式

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270

推荐阅读更多精彩内容