前言:
你可能也注意到了,html文件中的关于js的引用是我们手动写的,那假如我们改了输出路径或打包编译之后的文件名,那我们岂不是还要手动去修改html文件中的引用?我们怎么做到,像create-react-app中那样一旦你修改了某个文件内容,页面会自己刷新?我们来一步一步实现它们,当然,这一小节不仅仅只是为了完成这两点。
上一节:从零配置webpack 4+react脚手架(一)
自动编译html并引入js文件
public的index.html应该自动编译到dist目录,并且所有的js引用是自动添加的。你可以使用html-webpack-plugin插件来处理这个优化。
安装HtmlWebpackPlugin
在控制台执行以下代码:
npm install --save-dev html-webpack-plugin
在webpack.prod.config.js中配置plugins属性
const merge = require('webpack-merge');const common = require('./mon.config.js');const HtmlWebpackPlugin = require('html-webpack-plugin');module.exports = merge(common, {mode: 'production',plugins: [new HtmlWebpackPlugin({filename: 'index.html',// 这里有小伙伴可能会疑惑为什么不是 '../public/index.html'// 我的理解是无论与要用的template是不是在一个目录,都是从根路径开始查找template: 'public/index.html',inject: 'body',minify: {removeComments: true,collapseWhitespace: true,},})]});
filename:打包之后的html文件名字template:以我们自己定义的html为模板生成,不然我们还要到打包之后的html文件中写inject:在body最底部引入js文件,如果是head,就是在head中引入jsminify:压缩html文件,更多配置点我removeComments:去除注释collapseWhitespace:去除空格
更多配置请点击官方README
删除index.html中手动引入的script标签
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta http-equiv="X-UA-Compatible" content="ie=edge"><title>从零配置webpack4+react脚手架</title></head><body><div id="root"></div></body></html>
现在我们再来打包试试,看看dist中是不是多出了html文件,并且自动引入了script,用浏览器打开它试试看是不是能正确输出内容了!
给打包出的js文件换个不确定名字
这个操作是为了防止因为浏览器缓存带来的业务代码更新,而页面却没变化的问题,你想想看,假如客户端请求js文件的时候发现名字是一样的,那么它很有可能不发新的数据包,而直接用之前缓存的文件,当然,这和缓存策略有关。
那我们怎么给导出文件的安排一个不确定的名字呢?很简单,[hash]或[chunkhash]
修改webpck.prod.config.js
:
const merge = require('webpack-merge');const common = require('./mon.config.js');const HtmlWebpackPlugin = require('html-webpack-plugin');module.exports = merge(common, {mode: 'production',output: {filename: 'js/[name].[chunkhash:8].bundle.js',},plugins: [new HtmlWebpackPlugin({filename: 'index.html',template: 'public/index.html',inject: 'body',minify: {removeComments: true,collapseWhitespace: true,},})]});
其中,name
就是模块名称,我们在entry中进行过配置,在这里重新设置会代替之前common中的设置,chunkhash
是文件内容的hash,webpack默认采用md5的方式对文件进行hash。8是hash的长度,如果不设置,webpack会设置默认值为20。
现在你重新打包,去看看生成的js文件的名字~
打包编译前清理dist目录
在上面的修改后,因为js文件名字不同,你之后再打包,会把之前打包之后的js文件也留下,我们只想要最新打包编译的文件,就需要先清除dist目录,再重新生成。
安装clean-webpack-plugin
npm install --save-dev clean-webpack-plugin
这个插件不被官方文档所收录,可以去github查看它的配置文档
使用clean-webpack-plugin
修改webpck.prod.config.js
:
const merge = require('webpack-merge');const common = require('./mon.config.js');const HtmlWebpackPlugin = require('html-webpack-plugin');const {CleanWebpackPlugin } = require('clean-webpack-plugin');module.exports = merge(common, {mode: 'production',output: {filename: 'js/[name].[chunkhash:8].bundle.js',},plugins: [new HtmlWebpackPlugin({filename: 'index.html',template: 'public/index.html',inject: 'body',minify: {removeComments: true,collapseWhitespace: true,},}),new CleanWebpackPlugin()]});
这里需要注意:之前引入CleanWebpackPlugin的写法是const CleanWebpackPlugin = require('clean-webpack-plugin');
而且在下面new的时候需要传入参数,dist文件路径。但是现在必须这样引入:const {CleanWebpackPlugin} = require('clean-webpack-plugin');
而且,不用再写路径参数
现在再来执行看看,是不是只有一个js文件了!~
代码分割
我们先看下,我们之前打包编译的时候,控制台的信息:
我们看到,这个打包之后的bundle.js文件大小为129kb,随着业务代码越来越多,这个包会变得越来越大,你每次修改了代码并发布,用户都需要重新下载这个包,但是想想看,我们修改的代码只是整个代码的一小部分,还有许多其他不变的代码,例如react
和react-dom
,那我们把这部分不变的代码单独打包。
修改mon.config.js
,增加一个入口:
entry: {index: './src/index.js',framework: ['react','react-dom'],},
重新打包,发现react和react-dom 被编译成framework.js,但是我们的index.bundle.js还是129kb,没有变过。
这是因为我们还没有抽离index.js中的公共代码。
webpack3版本是通过配置CommonsChunkPlugin插件来抽离公共的模块。webpack4版本,官方废弃了CommonsChunkPlugin,而是改用配置optimization.splitChunks的方式,更加方便。
添加代码至webpack.prod.config.js
:
module.exports = {//...optimization: {splitChunks: {chunks: 'all',minSize: 30000,maxSize: 0,minChunks: 1,cacheGroups: {framework: {test: "framework",name: "framework",enforce: true},vendors: {priority: -10,test: /node_modules/,name: "vendor",enforce: true,},}}},//...};
cacheGroups对象,定义了需要被抽离的模块,其中test属性是比较关键的一个值,他可以是一个字符串,也可以是正则表达式,还可以是函数。如果定义的是字符串,会匹配入口模块名称,会从其他模块中把包含这个模块的抽离出来。name是抽离后生成的名字,和入口文件模块名称相同,这样抽离出来的新生成的framework模块会覆盖被抽离的framework模块,虽然他们都叫framework。
vendors这个缓存组,它的test设置为 /node_modules/ 表示只筛选从node_modules文件夹下引入的模块,所以所有第三方模块才会被拆分出来。
重新打包,我们发现index.bundle.js文件大小只有:1.69kb
我们随意修改一下app.js中的内容,比如
import React from 'react';function App() {return (<div className="App"><h1>I am changed</h1></div>);}export default App;
再打包一次,你会发现index.bundle.js(不被缓存)的hash值变了,但是freamework.bundle.js(能被缓存)的hash值没变,成了成了!!
压缩JS文件
我们需要把打包生成的js文件尽可能压缩,以便减少文件体积,更快地被用户加载。
我们需要一个插件:uglifyjs-webpack-plugin
来做这份工作
安装uglifyjs-webpack-plugin
在控制台执行以下代码:
npm install uglifyjs-webpack-plugin --save-dev
引入uglifyjs-webpack-plugin
增加如下代码至webpack.prod.config.js
:
const UglifyJsPlugin = require('uglifyjs-webpack-plugin');
optimization内配置minimizer参数
minimizer: [new UglifyJsPlugin(),//...],
现在optimization参数应该是现在这样:
optimization: {minimizer: [new UglifyJsPlugin()],splitChunks: {chunks: 'all',minSize: 30000,maxSize: 0,minChunks: 1,cacheGroups: {framework: {priority: 100,test: "framework",name: "framework",enforce: true},vendors: {priority: -10,test: /node_modules/,name: "vendor",enforce: true,},}}},
重新打包编译看看~我们的index.bundle.js减少了0.1kb,当然,随着业务代码越来越多,这部分差距会渐渐变大。
自动编译打包
我们每次修改代码,查看结果都要经历以此npm run build
,大大降低了开发效率,这难以忍受!
webpack给我们提供了devServer开发环境,支持热更新,相当舒服。
安装webpack-dev-server
在控制台执行以下代码:
npm install webpack-dev-server --save-dev
增加代码至webpack.dev.config.js
:
是不是都快忘记这个之前创建的配置文件了?没关系,反正也没代码,它是专门用来配置我们开发环境的
const path = require('path');const merge = require('webpack-merge');const common = require('./mon.config.js');const webpack = require('webpack');const HtmlWebpackPlugin = require('html-webpack-plugin');module.exports = merge(common, {mode: 'development',output: {filename: 'js/[name].[hash:8].bundle.js',},devServer: {contentBase: path.resolve(__dirname, '../dist'),open: true,port: 9000,compress: true,hot: true},plugins: [new HtmlWebpackPlugin({template: 'public/index.html',inject: 'body',hash: false}),new webpack.HotModuleReplacementPlugin()]});
HotModuleReplacementPlugin
是webpack热更新的插件,设置devServer.hot
为true,并且在plugins中引入HotModuleReplacementPlugin插件即可。
还需要注意的是我们开启了hot,那么导出不能使用chunkhash,需要替换为hash。
修改我们的package.json
像之前build的时候,我们是通过配置package.json做到的,现在我们同样加入以下代码来模拟:
"scripts": {"test": "echo "Error: no test specified" && exit 1","build": "webpack --config ./config/webpack.prod.config.js",+ "start": "webpack-dev-server --inline --config ./config/webpack.dev.config.js"},
接下来,在控制台执行
npm run start
是不是自动开了一个端口为9000的网页,上面是我们写的页面内容,这和我们的配置都是一一对应的。
现在你随意修改app.js中的代码,再回到页面看下是不是也跟着变了,那我们就整合webpack-dev-server成功!
下面一小节我们会配置css相关的属性,加油!
这是我的github/blog,欢迎star,会陆续推出更多学习文章。