閱讀目錄
一. 理解使用hash
一般情況下,對於前端靜態資源,瀏覽器訪問的時候希望資源都能夠進行緩存,當第二次及以后進入頁面的時候,頁面就可以直接使用緩存資源,這樣的話,頁面打開速度很快,提高了用戶體驗同時也節省了帶寬資源。而其中最為常見的一種最大化利用緩存的形式就是為靜態資源加上hash, 使用一個不會重復的標識符來達到資源可以永久緩存的目的。
瀏覽器緩存方法有很多種,那么下面我們分別使用hash, chunkhash和contenthash來理解下。
在理解hash, chunkhash和contenthash之前,我們首先看看我們項目的基本架構如下:
### 目錄結構如下: demo1 # 工程名 | |--- dist # 打包后生成的目錄文件 | |--- node_modules # 所有的依賴包 | |--- js # 存放所有js文件 | | |-- demo1.js | | |-- main.js # js入口文件 | |--- webpack.config.js # webpack配置文件 | |--- webpack.dll.config.js # 打包第三方依賴的庫文件 | |--- index.html # html文件 | |--- styles # 存放所有的css樣式文件 | | |-- main.styl # main.styl文件 | | |-- index.styl | |--- .gitignore | |--- README.md | |--- package.json | |--- .babelrc # babel轉碼文件
1. 理解使用hash
hash的默認長度為20個字符,可以使用[hash:8]這樣的方式來配置,代表hash使用8個字符來表示。
webpack.config.js 配置代碼如下(入口文件分別為main和demo1):
module.exports = { // 入口文件 entry: { main: './js/main.js', demo1: './js/demo1.js' }, output: { filename: '[name].[hash].js', // 將輸出的文件都放在dist目錄下 path: path.resolve(__dirname, 'dist') } }
在dist目錄打包成如下:
如上可以看到,main.js中hash編碼和demo1.js中的hash編碼是一模一樣的。現在我改下main.js代碼后,繼續打包一下可以看到如下信息:
可以看到,demo1.js代碼其實我並沒有改動,但是它因為main.js代碼改動了導致他的hash編碼也改變了。
hash理解為:當每次修改任何一個文件后,所有文件打包后的hash值都是一樣的,所以假如只是修改了任何一個文件,整個項目的文件緩存都將失效。
hash為什么會這樣呢?要理解這個問題,首先我們需要理解 the module identifier。webpack默認會為各個模塊分配一個id作為標識,用來處理模塊之間的依賴關系,但是默認的id命名規則則是根據模塊引入的順序,賦予一個整數 (1,2,3..). 由於該hash是基於整個 module identifier序列計算得到的,因此js打包的時候使用該hash,所有的值都一樣的,但是任意刪除或者修改任何一個文件的時候,都會對整個id序列造成影響,從而改變hash的值。
二:理解使用chunkhash
上面的hash有這個缺點,因此chunkhash出現了,它就是解決這個問題而出現的。我們接下來再把配置改成如下:
module.exports = { entry: { main: './js/main.js', demo1: './js/demo1.js' }, output: { filename: '[name].[chunkhash].js', // 將輸出的文件都放在dist目錄下 path: path.resolve(__dirname, 'dist') } };
我們繼續運行打包完后,變成如下:
可以看到這時候main.js和demo1.js中的hash編碼不一樣了,因此接下來我們繼續隨便修改下main.js代碼,繼續打包如下:
如上可以看到,我們只是改變了下 main.js代碼,demo1.js代碼並沒有改變,因此main.js代碼的hash編碼值改變了,demo1.js的hash值編碼並沒有改變,因此當某個文件改變的時候,只會重新請求該文件,未改變的文件不會重新請求,會緩存里面讀取。
三:對第三方庫打包后使用緩存
通過上面使用chunkhash, 因此對於一些常用的庫,第三方文件我們也可以使用chunkhash這么做,這樣一來的話,第三方庫文件在瀏覽器中會加載很快,因此對於第三方庫文件我打算輸出到 項目中另一個文件內,比如叫plugins文件夾內,比如如下webpack.dll.config.js 代碼如下:
const path = require('path'); const DllPlugin = require('webpack/lib/DllPlugin'); module.exports = { // 入口文件 entry: { // 項目中用到該兩個依賴庫文件 jquery: ['jquery'], echarts: ['echarts'] }, // 輸出文件 output: { // 文件名稱 filename: '[name].dll.[chunkhash].js', // 將輸出的文件放到dist目錄下 path: path.resolve(__dirname, './plugins'), /* 存放相關的dll文件的全局變量名稱,比如對於jquery來說的話就是 _dll_jquery, 在前面加 _dll 是為了防止全局變量沖突。 */ library: '_dll_[name]' }, mode: 'development', plugins: [ // 使用插件 DllPlugin new DllPlugin({ /* 該插件的name屬性值需要和 output.library保存一致,該字段值,也就是輸出的 manifest.json文件中name字段的值。 比如在jquery.manifest文件中有 name: '_dll_jquery' */ name: '_dll_[name]', /* 生成manifest文件輸出的位置和文件名稱 */ path: path.join(__dirname, './plugins', '[name].manifest.json') }) ] };
webpack.config.js 代碼如下:
const path = require('path'); // 提取css的插件 const ExtractTextPlugin = require('extract-text-webpack-plugin'); // 清除dist目錄下的文件 const ClearWebpackPlugin = require('clean-webpack-plugin'); const webpack = require('webpack'); // 引入打包html文件 const HtmlWebpackPlugin = require('html-webpack-plugin'); // 引入 DllReferencePlugin const DllReferencePlugin = require('webpack/lib/DllReferencePlugin'); // 引入HappyPack插件 const HappyPack = require('happypack'); module.exports = { // 入口文件 entry: { main: './js/main.js', demo1: './js/demo1.js' }, output: { filename: '[name].[chunkhash].js', // 將輸出的文件都放在dist目錄下 path: path.resolve(__dirname, 'dist') }, module: { rules: [ { // 使用正則去匹配 test: /\.styl$/, use: ExtractTextPlugin.extract({ fallback: { loader: 'style-loader' }, use: [ { loader: 'css-loader', options: {} }, { loader: 'postcss-loader', options: { ident: 'postcss', plugins: [ require('postcss-cssnext')(), require('cssnano')(), require('postcss-pxtorem')({ rootValue: 16, unitPrecision: 5, propWhiteList: [] }), require('postcss-sprites')() ] } }, { loader: 'stylus-loader', options: {} } ] }) }, { test: /\.css$/, use: ExtractTextPlugin.extract({ use: ['happypack/loader?id=css-pack'] }) }, { test: /\.(png|jpg)$/, /* loader: 'url-loader', options: { limit: 10000, name: '[name].[ext]' } */ use: ['happypack/loader?id=image'] }, { test: /\.js$/, // 將對.js文件的處理轉交給id為babel的HappyPack的實列 use: ['happypack/loader?id=babel'], // loader: 'babel-loader', exclude: path.resolve(__dirname, 'node_modules') // 排除文件 } ] }, resolve: { extensions: ['*', '.js', '.json'] }, devtool: 'cheap-module-eval-source-map', devServer: { // contentBase: path.join(__dirname, "dist"), port: 8081, host: '0.0.0.0', headers: { 'X-foo': '112233' }, // hot: true, inline: true, // open: true, overlay: true, stats: 'errors-only' }, mode: 'development', plugins: [ new HtmlWebpackPlugin({ template: './index.html' // 模版文件 }), new ClearWebpackPlugin(['dist']), new ExtractTextPlugin({ // 從js文件中提取出來的 .css文件的名稱 filename: `main.[chunkhash].css` }), // 告訴webpack使用了哪些第三方庫代碼 new DllReferencePlugin({ context: path.join(__dirname), // jquery 映射到json文件上去 manifest: require('./plugins/jquery.manifest.json') }), new DllReferencePlugin({ context: path.join(__dirname), // echarts 映射到json文件上去 manifest: require('./plugins/echarts.manifest.json') }), /**** 使用HappyPack實例化 *****/ new HappyPack({ // 用唯一的標識符id來代表當前的HappyPack 處理一類特定的文件 id: 'babel', // 如何處理.js文件,用法和Loader配置是一樣的 loaders: ['babel-loader'] }), new HappyPack({ id: 'image', loaders: [{ loader: require.resolve('url-loader'), options: { limit: 10000, name: '[name].[ext]' } }] }), // 處理styl文件 new HappyPack({ id: 'css-pack', loaders: ['css-loader'] }) ] };
打包后變成如下:
第三方庫文件一般情況下不會輕易更改,因此我們在頁面上引用的時候,直接把hash編碼值帶上,當第二次瀏覽器訪問的時候,第三方庫文件會直接從緩存里面讀取(除js緩存時間過期以外),這樣的話,瀏覽器加載速度會更快。
四:contenthash
如上,第三方庫文件已經解決了使用緩存了,但是css文件並沒有,比如在main.js代碼內部應用了 main.styl, main.js代碼如下:
require('../styles/main.styl'); $('#app').html('歡迎你來我的博客'); console.log('這是main.js'); console.log(22333); require('./demo1.js');
如下圖所示:
main.js 和 main.css 的hash編碼是一樣,因此我現在繼續更改main.js, 隨便加一行代碼,然后繼續打包,會看到main.css的hash編碼也會跟着改變,其實main.css的文件並沒有更改,其實我是想main.css直接還是使用緩存就好。
也就是說 更改那個文件,就對那個文件使用新的hash編碼。沒有更改過的文件,hash編碼不變。
main.js 代碼變為如下:
require('../styles/main.styl'); $('#app').html('歡迎你來我的博客'); console.log('這是main.js'); console.log(22333); require('./demo1.js'); // 新增一行代碼 console.log(22333111);
然后繼續打包,如下圖所示:
也可以看到main.css的hash編碼是跟着 main.js 編碼變動的。
其實根本原因還是 module identifier,因為 main.js 新引入的模塊main.styl, 它改變了以后所有模塊的 id 值,所以 main.css 文件中引入的模塊值發生了改變,於是 main.styl 的 chunkhash 也隨着發生改變。
為了解決這個問題,contenthash就出來了。
首先要分離css,之前是使用 extract-text-webpack-plugin 插件,現在我們為了使用 contenthash,因此需要使用mini-css-extract-plugin插件就可以了。具體配置代碼如下:
// 引入 mini-css-extract-plugin 插件 const MiniCssExtractPlugin = require('mini-css-extract-plugin'); module.exports = { module: { { // 使用正則去匹配 test: /\.styl$/, /* use: ExtractTextPlugin.extract({ fallback: { loader: 'style-loader' }, use: [ { loader: 'css-loader', options: {} }, { loader: 'postcss-loader', options: { ident: 'postcss', plugins: [ require('postcss-cssnext')(), require('cssnano')(), require('postcss-pxtorem')({ rootValue: 16, unitPrecision: 5, propWhiteList: [] }), require('postcss-sprites')() ] } }, { loader: 'stylus-loader', options: {} } ] }) */ use: [ MiniCssExtractPlugin.loader, { loader: 'css-loader', options: {} }, { loader: 'postcss-loader', options: { ident: 'postcss', plugins: [ require('postcss-cssnext')(), require('cssnano')(), require('postcss-pxtorem')({ rootValue: 16, unitPrecision: 5, propWhiteList: [] }), require('postcss-sprites')() ] } }, { loader: 'stylus-loader', options: {} } ] }, { test: /\.css$/, use: [ MiniCssExtractPlugin.loader, 'happypack/loader?id=css-pack' ] /* use: ExtractTextPlugin.extract({ use: ['happypack/loader?id=css-pack'] }) */ } }, plugins: [ new MiniCssExtractPlugin({ filename: '[name].[contenthash:8].css' }) ] }
因此webpack.config.js 所有代碼如下:
const path = require('path'); // 提取css的插件 const ExtractTextPlugin = require('extract-text-webpack-plugin'); // 引入 mini-css-extract-plugin 插件 const MiniCssExtractPlugin = require('mini-css-extract-plugin'); // 清除dist目錄下的文件 const ClearWebpackPlugin = require('clean-webpack-plugin'); const webpack = require('webpack'); // 引入打包html文件 const HtmlWebpackPlugin = require('html-webpack-plugin'); // 引入 DllReferencePlugin const DllReferencePlugin = require('webpack/lib/DllReferencePlugin'); // 引入HappyPack插件 const HappyPack = require('happypack'); module.exports = { // 入口文件 entry: { main: './js/main.js', demo1: './js/demo1.js' }, output: { filename: '[name].[chunkhash].js', // 將輸出的文件都放在dist目錄下 path: path.resolve(__dirname, 'dist') }, module: { rules: [ { // 使用正則去匹配 test: /\.styl$/, /* use: ExtractTextPlugin.extract({ fallback: { loader: 'style-loader' }, use: [ { loader: 'css-loader', options: {} }, { loader: 'postcss-loader', options: { ident: 'postcss', plugins: [ require('postcss-cssnext')(), require('cssnano')(), require('postcss-pxtorem')({ rootValue: 16, unitPrecision: 5, propWhiteList: [] }), require('postcss-sprites')() ] } }, { loader: 'stylus-loader', options: {} } ] }) */ use: [ MiniCssExtractPlugin.loader, { loader: 'css-loader', options: {} }, { loader: 'postcss-loader', options: { ident: 'postcss', plugins: [ require('postcss-cssnext')(), require('cssnano')(), require('postcss-pxtorem')({ rootValue: 16, unitPrecision: 5, propWhiteList: [] }), require('postcss-sprites')() ] } }, { loader: 'stylus-loader', options: {} } ] }, { test: /\.css$/, use: [ MiniCssExtractPlugin.loader, 'happypack/loader?id=css-pack' ] /* use: ExtractTextPlugin.extract({ use: ['happypack/loader?id=css-pack'] }) */ }, { test: /\.(png|jpg)$/, /* loader: 'url-loader', options: { limit: 10000, name: '[name].[ext]' } */ use: ['happypack/loader?id=image'] }, { test: /\.js$/, // 將對.js文件的處理轉交給id為babel的HappyPack的實列 use: ['happypack/loader?id=babel'], // loader: 'babel-loader', exclude: path.resolve(__dirname, 'node_modules') // 排除文件 } ] }, resolve: { extensions: ['*', '.js', '.json'] }, devtool: 'cheap-module-eval-source-map', devServer: { // contentBase: path.join(__dirname, "dist"), port: 8081, host: '0.0.0.0', headers: { 'X-foo': '112233' }, // hot: true, inline: true, // open: true, overlay: true, stats: 'errors-only' }, mode: 'development', plugins: [ new HtmlWebpackPlugin({ template: './index.html' // 模版文件 }), new ClearWebpackPlugin(['dist']), /* new ExtractTextPlugin({ // 從js文件中提取出來的 .css文件的名稱 filename: `[name].[contenthash:8].css` }), */ new MiniCssExtractPlugin({ filename: '[name].[contenthash:8].css' }), // 告訴webpack使用了哪些第三方庫代碼 new DllReferencePlugin({ context: path.join(__dirname), // jquery 映射到json文件上去 manifest: require('./plugins/jquery.manifest.json') }), new DllReferencePlugin({ context: path.join(__dirname), // echarts 映射到json文件上去 manifest: require('./plugins/echarts.manifest.json') }), /**** 使用HappyPack實例化 *****/ new HappyPack({ // 用唯一的標識符id來代表當前的HappyPack 處理一類特定的文件 id: 'babel', // 如何處理.js文件,用法和Loader配置是一樣的 loaders: ['babel-loader'] }), new HappyPack({ id: 'image', loaders: [{ loader: require.resolve('url-loader'), options: { limit: 10000, name: '[name].[ext]' } }] }), // 處理styl文件 new HappyPack({ id: 'css-pack', loaders: ['css-loader'] }), new webpack.HashedModuleIdsPlugin() ] };
通過如上配置后,我們再打包一下看下如下所示:
當我修改main.js代碼后,再進行打包,會生成文件如下,如下圖所示:
現在我們繼續改下main.styl代碼,繼續打包,看是否main.css的hash編碼的變化,如下圖所示
如上我們可以看到修改main.styl后,main.js代碼的hash變化也發生變化了。
因此在打包js中,我們需要使用 contenthash 就可以了,配置文件如下:
module.exports = { // 入口文件 entry: { main: './js/main.js', demo1: './js/demo1.js' }, output: { filename: '[name].[contenthash].js', // 將輸出的文件都放在dist目錄下 path: path.resolve(__dirname, 'dist') } }
因此webpack.config.js所有代碼如下:
const path = require('path'); // 提取css的插件 const ExtractTextPlugin = require('extract-text-webpack-plugin'); // 引入 mini-css-extract-plugin 插件 const MiniCssExtractPlugin = require('mini-css-extract-plugin'); // 清除dist目錄下的文件 const ClearWebpackPlugin = require('clean-webpack-plugin'); const webpack = require('webpack'); // 引入打包html文件 const HtmlWebpackPlugin = require('html-webpack-plugin'); // 引入 DllReferencePlugin const DllReferencePlugin = require('webpack/lib/DllReferencePlugin'); // 引入HappyPack插件 const HappyPack = require('happypack'); module.exports = { // 入口文件 entry: { main: './js/main.js', demo1: './js/demo1.js' }, output: { filename: '[name].[contenthash].js', // 將輸出的文件都放在dist目錄下 path: path.resolve(__dirname, 'dist') }, module: { rules: [ { // 使用正則去匹配 test: /\.styl$/, /* use: ExtractTextPlugin.extract({ fallback: { loader: 'style-loader' }, use: [ { loader: 'css-loader', options: {} }, { loader: 'postcss-loader', options: { ident: 'postcss', plugins: [ require('postcss-cssnext')(), require('cssnano')(), require('postcss-pxtorem')({ rootValue: 16, unitPrecision: 5, propWhiteList: [] }), require('postcss-sprites')() ] } }, { loader: 'stylus-loader', options: {} } ] }) */ use: [ MiniCssExtractPlugin.loader, { loader: 'css-loader', options: {} }, { loader: 'postcss-loader', options: { ident: 'postcss', plugins: [ require('postcss-cssnext')(), require('cssnano')(), require('postcss-pxtorem')({ rootValue: 16, unitPrecision: 5, propWhiteList: [] }), require('postcss-sprites')() ] } }, { loader: 'stylus-loader', options: {} } ] }, { test: /\.css$/, use: [ MiniCssExtractPlugin.loader, 'happypack/loader?id=css-pack' ] /* use: ExtractTextPlugin.extract({ use: ['happypack/loader?id=css-pack'] }) */ }, { test: /\.(png|jpg)$/, /* loader: 'url-loader', options: { limit: 10000, name: '[name].[ext]' } */ use: ['happypack/loader?id=image'] }, { test: /\.js$/, // 將對.js文件的處理轉交給id為babel的HappyPack的實列 use: ['happypack/loader?id=babel'], // loader: 'babel-loader', exclude: path.resolve(__dirname, 'node_modules') // 排除文件 } ] }, resolve: { extensions: ['*', '.js', '.json'] }, devtool: 'cheap-module-eval-source-map', devServer: { // contentBase: path.join(__dirname, "dist"), port: 8081, host: '0.0.0.0', headers: { 'X-foo': '112233' }, // hot: true, inline: true, // open: true, overlay: true, stats: 'errors-only' }, mode: 'development', plugins: [ new HtmlWebpackPlugin({ template: './index.html' // 模版文件 }), new ClearWebpackPlugin(['dist']), /* new ExtractTextPlugin({ // 從js文件中提取出來的 .css文件的名稱 filename: `[name].[contenthash:8].css` }), */ new MiniCssExtractPlugin({ filename: '[name].[contenthash:8].css' }), // 告訴webpack使用了哪些第三方庫代碼 new DllReferencePlugin({ context: path.join(__dirname), // jquery 映射到json文件上去 manifest: require('./plugins/jquery.manifest.json') }), new DllReferencePlugin({ context: path.join(__dirname), // echarts 映射到json文件上去 manifest: require('./plugins/echarts.manifest.json') }), /**** 使用HappyPack實例化 *****/ new HappyPack({ // 用唯一的標識符id來代表當前的HappyPack 處理一類特定的文件 id: 'babel', // 如何處理.js文件,用法和Loader配置是一樣的 loaders: ['babel-loader'] }), new HappyPack({ id: 'image', loaders: [{ loader: require.resolve('url-loader'), options: { limit: 10000, name: '[name].[ext]' } }] }), // 處理styl文件 new HappyPack({ id: 'css-pack', loaders: ['css-loader'] }), // new webpack.HashedModuleIdsPlugin() ] };
webpack.config.js 代碼如上配置,首先我們先打包完成后,查看打包后的文件如下:
當我們隨便改動下main.js文件,可以看到如下對應main.js的hash編碼發生改動,如下代碼文件:
接着我們繼續改動下main.styl文件中的代碼,可以看到如下圖demo1.js和main.js的hash編碼並沒有改動,
只有main.css文件的hash編碼發生改動了,如下圖所示: