什么是文件指纹
文件指纹是文件打包后输出的文件名的后缀,通常用来做一些文件的版本管理
文件指纹的作用
- 用作版本管理时,如果一个项目需要发布,只需要发布修改过的文件指纹;
- 对于没有修改过的文件,用户在访问的时候,依旧可以使用浏览器缓存好的,无需二次加载,加速页面访问。
文件指纹策略
-
Hash 和整个项目的构建相关,只要项目文件有修改,整个项目构建的hash值就会更改,并且全部文件都共用相同的hash值 -
Chunkhash 和webpack打包的chunk有关,不同的entyr会生成不同的Chunkhash值(一个页面的值改变了并不会影响另一个页面,js文件一般采用此方法),chunkhash和hash不一样,它根据不同的入口文件(Entry)进行依赖文件解析、构建对应的chunk,生成对应的哈希值。我们在生产环境里把一些公共库和程序入口文件区分开,单独打包构建,接着我们采用chunkhash的方式生成哈希值,那么只要我们不改动公共库的代码,就可以保证其哈希值不会受影响。 -
Contenthash 根据文件内容来定义hash,文件内容不变,则contenthash不变(css文件一般采用此方法)。 比如文件index.css被index.js引用了,所以共用相同的chunkhash值。但是这样子有个问题,如果index.js更改了代码,css文件就算内容没有任何改变,由于是该模块发生了改变,导致css文件会重复构建。 这个时候,我们可以使用extra-text-webpack-plugin里的contenthash值,保证即使css文件所处的模块里就算其他文件内容改变,只要css文件内容不变,那么不会重复构建。
hash一般是结合CDN缓存来使用,通过webpack构建之后,生成对应文件名自动带上对应的MD5值。如果文件内容改变的话,那么对应文件哈希值也会改变,对应的HTML引用的URL地址也会改变,触发CDN服务器从源服务器上拉取对应数据,进而更新本地缓存。但是在实际使用的时候,这几种hash计算还是有一定区别。
占位符介绍
占位符名称 | 定义 |
---|
[ext] | 资源后缀名 | [name] | 文件名称 | [path] | 文件的相对路径 | [folder] | 文件所在的文件夹 | [contenthash] | 文件的内容hash,默认是md5生成 | [hash] | 文件的内容hash,默认是md5生成 | [emoji] | 一个随机的指代文件内容的emoji |
文件指纹的设置
根据不同的文件类型一般选择不同的文件指纹策略,通常情况下:
- JS文件采用[chunkhash]文件指纹策略
- CSS文件采用[contenthash]文件指纹策略
- JS文件采用[hash]文件指纹策略
下面我们来介绍下几种用法
JS文件指纹设置
设置output 的filename ,使用[chunkhash] ,chunkhash 没办法和热更新一起使用的,不能与HotModuleReplacementPlugin 这个插件一起使用,所以我们只在生产环境写。
output: {
path: path.join(__dirname, 'dist'),
filename: '[name]_[chunkhash:8].js'
}
图片文件指纹设置
设置file-loader 的name ,使用[hash] 。
module: {
rules: [
{
test: /.(png|jpg|gif|jpeg)$/,
use: {
loader: "url-loader",
options: {
name: '[name]_[hash:8].[ext]',
limit: 10240
}
}
},
},
CSS文件指纹设置
CSS文件指纹策略比较特殊,我们需要用到MiniCssExtractPlugin ,设置MiniCssExtractPlugin 的 filename ,使用[contenthash] 。
正常情况下,如果我们使用了style-loader 和css-loader 的话,那么这个css 会由style-loader 将css 插入到style 里面,并且放到head 头部,此时并没有一个独立的css 文件,因此,我们通常会采用MiniCssExtractPlugin ,通过这个插件把这个style-loader 的css 提取成一个独立的文件,所以,对于这个css 的文件指纹,我们会设置在这个MiniCssExtractPlugin 里面,给它设置一个filename ,并且给它设置一个[contenthash] 。
注意:MiniCssExtractPlugin 这个插件没办法与style-loader 一起使用,因为它们之间的功能是互斥的,所以需要将style-loader 换成MiniCssExtractPlugin.loader 。
设置步骤
-
首先安装MiniCssExtractPlugin npm i -D mini-css-extract-plugin
-
配置webpack.config.js const MiniCssExtractPlugin = require('mini-css-extract-plugin');
......
module.exports = {
plugins: [
new MiniCssExtractPlugin({
filename: '[name][contenthash:8].css'
})
],
}
文件指纹项目应用
将webpack.config.js 文件更名为webpack.dev.js 并将内部的mode 修改为development ,再复制一份文件,更名为webpack.prod.js 将mode 修改为production 。
然后需要修改配置文件package.json区分production和development
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"build": "webpack --config webpack.prod.js",
"watch": "webpack --watch --progress",
"dev": "webpack-dev-server -config webpack.dev.js --open"
}
完成上述步骤,我们在项目中就可以根据生产环境和开发环境不同,配置不同的文件指纹。
|