除了的webpack
基本配置,还可以进一步添加配置,优化合并文件,加快编译速度。下面是生产环境配置文件webpack.production.js
,与wenbpack.config.js
相比其不需要一些dev-tools
,dev-server
和jshint
校验等,将与开发相关的东西删掉。下面的介绍均以此代码配置作参考。
点击查看代码
/*生成环境配置文件:不需要一些dev-tools,dev-server和jshint校验等。和开发有关的东西删掉*/
var webpack = require('webpack');
var path = require('path');
var node_modules = path.resolve(__dirname, 'node_modules');
var pathToReact = path.resolve(node_modules, 'react/dist/react.min.js');
var pathToReactDOM = path.resolve(node_modules, 'react-dom/dist/react-dom.min.js');
var ExtractTextPlugin = require('extract-text-webpack-plugin');
var HtmlWebpackPlugin = require('html-webpack-plugin');
//具体作用及缺点见plugins中的描述
//var WebpackMd5Hash = require('webpack-md5-hash');
// 该插件是对“webpack-md5-hash”的改进:在主文件中获取到各异步模块的hash值,然后将这些hash值与主文件的代码内容一同作为计算hash的参数,这样就能保证主文件的hash值会跟随异步模块的修改而修改。
var WebpackSplitHash = require('webpack-split-hash');
var config = {
entry:{
app:path.resolve(__dirname, 'src/js/entry.js'),
mobile: path.resolve(__dirname, 'src/js/mobile.js'),
//添加要打包在vendors.js里面的库
vendors:['react','react-dom']
},
resolve:{
alias: {
'react.js': pathToReact, //alias:别名,
'react-dom.js': pathToReactDOM
},
fallback: path.join(__dirname, "node_modules")
},
resolveLoader: {
fallback: path.join(__dirname, "node_modules")
},
output:{
path:path.resolve(__dirname, 'dist'),
publicPath:'../',//生成的html里的引用路径用 publicPath
//以文件内容的MD5生成Hash名称的script来防止缓存
filename: 'js/[name].[chunkhash:8].js',
//异步加载的模块是要以文件形式加载,生成的文件名是以chunkFilename配置的
chunkFilename: 'js/[name].[chunkhash:8].js'
},
module:{
loaders:[{
test: /\.jsx?$/,
//这里(node_modules文件夹)再也不需通过任何第三方来加载
exclude:path.resolve(__dirname, 'node_modules'),
loader: 'babel',
query:{
presets:['es2015', 'react']
}
},
{
test:/\.css$/,
//loader:'style!css'
loader: ExtractTextPlugin.extract("style", "css")
},
{
test:/\.scss$/,
loader:'style!css!sass'
},
//url-loader:图片、字体图标加载器,是对file-loader的上层封装,支持base64编码。传入的size(也有的写limit) 参数是告诉它图片如果不大于 25KB 的话要自动在它从属的 css 文件中转成 BASE64 字符串。
{
test: /\.(png|jpg|jpeg|gif|svg|woff|woff2|ttf|eot)$/,
loader: 'url?limit=25000&name=[name].[ext]'
}]
},
plugins:[
//提取公共代码的插件,用于提取多个入口文件的公共脚本部分,然后生成一个vendors.js。注意HTML代码中要加载这个公共文件
new webpack.optimize.CommonsChunkPlugin({
name: 'vendors',
filename: 'js/vendors.js'
}),
//在文件开头插入banner
new webpack.BannerPlugin("The file is creted by yangmin.--"+ new Date()),
//压缩js文件
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
}
}),
/*插件:单独使用style标签加载css文件.contenthash代表的是文本文件内容的hash值,也就是只有style文件的hash值*/
new ExtractTextPlugin("css/[name].[contenthash:8].css"),//设置其路径(路径相对于path)
/*插件:动态生成html,在webpack完成前端资源打包以后,自动将打包后的资源路径和版本号写入HTML中,达到自动化的效果。*/
new HtmlWebpackPlugin({
filename:'view/index.html', //生成的html存放路径,相对于 path
template:'src/view/index.html', //html模板路径
inject:true, //允许插件修改哪些内容,true/'head'/'body'/false,
chunks:['vendors','app'],//加载指定模块中的文件,否则页面会加载所有文件
hash:false, //为静态资源生成hash值
minify:{ //压缩HTML文件
removeComments:false, //移除HTML中的注释
collapseWhitespace:false //删除空白符与换行符
}
}),
new HtmlWebpackPlugin({
filename:'view/mobile.html', //生成的html存放路径,相对于 path
template:'src/view/mobile.html', //html模板路径
inject:true, //允许插件修改哪些内容,true/'head'/'body'/false,
chunks:['vendors','mobile'],//加载指定模块中的文件,否则页面会加载所欲文件
hash:false, //为静态资源生成hash值
minify:{ //压缩HTML文件
removeComments:false, //移除HTML中的注释
collapseWhitespace:false //删除空白符与换行符
}
}),
/*作用:生成具有独立hash值的css和js文件,即css和js文件hash值解耦.
*缺点:webpack-md5-hash插件对chunk-hash钩子进行捕获并重新计算chunkhash,它的计算方法是只计算模块本身的当前内容(包括同步模块)。这种计算方式把异步模块的内容忽略掉了,会造成一个问题:异步模块的修改并未影响主文件的hash值。
*/
//new WebpackMd5Hash()
new WebpackSplitHash()
]
}
module.exports = config;
1、 在开发环境中使用压缩文件
例如ReactJS
项目中为了不让 Webpack
去遍历 React JS
及其所有依赖,你可以在webpack.config.js
中重写它的行为。
config.alias
: 每当 "react"
在代码中被引入,它会使用压缩后的 React JS
文件。
noParse
: 阻止Webpack
去解析那个压缩后的文件。
当加载多个压缩文件时,下述方法更优雅简便,webpack.production.js
:
点击查看代码
var webpack = require("webpack");
...
var HtmlWebpackPlugin = require('html-webpack-plugin');
var deps = [
'react/dist/react.min.js',
'react-dom/dist/react-dom.min.js'
];
var config = {
...
resolve:{
alias:{},
fallback:path.join(__dirname, "node_modules")
},
...
module:{
...
noParse:[]
}
}
/*当加载多个压缩文件时,下述方法更优雅简便*/
deps.forEach(function(dep){
var depPath = path.resolve(node_modules, dep);
//path.dep是路径分隔符。
config.resolve.alias[dep.split(path.dep)[0]] = depPath;
config.module.noParse.push(depPath);
});
module.exports = config;
二、分离应用和第三方文件
当你的应用依赖其他库尤其是像 React JS
这种大型库的时候,需要考虑把这些依赖分离出去,这样就能够让用户在你更新应用之后不需要再次下载第三方文件。上述配置文件中的entry
里添加了第三方包vendors
,其值为要分离打包的文件。运行配置后会在dist/js
下生成三个独立文件:app.js
、mobile.js
、vendors.js
。注意在页面中要引入vendors.js
点击查看代码
<script src="../dist/vendors.js"></script>
<script src="../dist/app.js"></script>
三、多重入口
当应用有多个页面, 页面之间虽然有共享代码,但是不想在页面中加载所有代码时可以定义多重入口。例如配置文件中的app.js
针对pc
端页面,mobile.js
仅针对移动端页面,output
的filename:'js/[name].[chunkhash:8].js'
,采用了文件名变量,这样在dist/js
中可生成与源文件同名的文件。
四、优化缓存及懒加载
在生产环境中,将输出文件名添加hash
值,目的是在文件更改时强制客户端重新加载这个文件,而未改变的文件继续使用缓存文件。常用的有hash
和chunkhash
。配置文件中的[chunkhash:8]
即截取8
位chunkhash
值。
webpack
的编译理念:webpack
将style
视为js
的一部分,所以在计算chunkhash
时,会把所有的js
代码和style
代码混合在一起计算。比如entry.js
引用了main.css
:
点击查看代码
import 'main.css';
alert('I am main.js');
webpack
计算chunkhash
时,以entry.js
文件为编译入口,整个chunk
的内容会将main.css
的内容也计算在内。所以,不论是修改了js
代码还是css
代码,整个chunk
的内容都改变了,计算所得的chunkhash
随之改变。但理想情况下是想css
或js
内容改变时仅影响自身文件的chunkhash
,这样客户端只需更新一部分文件。解决此问题首先要将css
单独编译输出文件,因为正常情况下webpack
会把js
文件中引入的css
文件编译输出到html
页面的<style></style>
标签中。
- 使用
extract-text-webpack-plugin
单独编译输出css
文件
安装extract-text-webpack-plugin
,
点击查看代码
npm install extract-text-webpack-plugin --save-dev
然后在配置文件中引入插件,
点击查看代码
//webpack.production.config.js
var ExtractTextPlugin = require('extract-text-webpack-plugin');
该插件除了chunkhash
还提供了另外一种hash
值contenthash
。顾名思义,contenthash
代表的是文本文件内容的hash
值,也就是只有style
文件的hash
值。此hash
是可解决上述问题的关键所在。上述配置文件使用了contenthash
:
点击查看代码
//webpack.production.config.js
new ExtractTextPlugin("css/[name].[contenthash:8].css"),//设置其路径(路径相对于path)
- 使用使用
webpack-md5-hash
解耦css
和js
文件hash
值
再考虑以下情况,只修改了main.css
文件,未修改entry.js
文件,编译输出的js
文件hash
是否改变?答案是改变了,因为上文提到的webpack
的编译理念,webpack
将style
视为js
的一部分,所以在计算chunkhash
时,会把所有的js
代码和style
代码混合在一起计算。解决办法是使用webpack-md5-hash
插件:
点击查看代码
//webpack.production.config.js
var WebpackMd5Hash = require('webpack-md5-hash');
...
new WebpackMd5Hash();
它的作用是生成具有独立hash
值的css
和js
文件,即css
和js
文件hash
值解耦。webpack-md5-hash
插件对chunk-hash
钩子进行捕获并重新计算chunkhash
,它的计算方法是只计算模块本身的当前内容(包括同步模块)。
- 主文件使用
hash
代替chunkhash
解决异步加载模块改变时主文件hash
不改变
假如文件中引入了异步模块,异步模块修改后会影响编译输出的js
文件的chunkhash
吗?现在入口文件中引入异步模块a.js
,a.js
文件又异步引入b.js
,b.js
同步引入c
模块
点击查看entry.js代码
'use strict';
import './saveCarInfo.js';
window.onload = function(){//懒加载
require.ensure(['./a.js'],function(require){
var moduleA = require('./a.js');
},'a');
};
点击查看a.js代码
'use strict'
console.log("a");
setTimeout(function(){
require.ensure([],function(require){
require('./b.js');
},'b');
},10000);
module.exports = "moduleA";
点击查看b.js代码
import fn_c from './c.js';
console.log('b');
module.exports = 'moduleB';
点击查看c.js代码
console.log("c");
module.exports = "moduleC";
运行npm run deploy
,编译输出如下,我们看到除了入口文件、css
文件、html
文件被输出外,异步加载的模块a.js
、b.js
也被当做独立模块输出。
此时修改a.js
文件中的代码,经编译后,a.[chunkhash].js
的chunkhash
会改变,而生成的主文件app.[chunkhash].js
的chunkhash
值并没有改变。原因是webpack-md5-hash
的这种计算方式把异步模块的内容忽略掉了,这会造成一个问题:异步模块的修改并未影响主文件的chunkhash
值。解决办法是将输出的主文件采用[hash]
,而非[chunkhash]
点击查看代码
output:{
path:path.resolve(__dirname, 'dist'),
publicPath:'../',//生成的html里的引用路径用 publicPath
filename: 'js/[name].[hash:8].js',
//异步加载的模块是要以文件形式加载,生成的文件名是以chunkFilename配置的
chunkFilename: 'js/[name].[chunkhash:8].js'
},
这种做法也存在缺陷,如果项目中存在不止一个主js
文件,修改任意js
代码会影响所有最终主文件的[hash]
值。例如上面的项目配置中会生成两个带[hash]
的主文件:app.[hash].js
, mobile.[hash].js
。无论是修改entry.js
代码还是异步模块a.js
,或b.js
的代码,app.[hash].js
和mobile.[hash].js
的[hash]
都会改变。
补充:npm
提供了webpack-split-hash
插件代替webpack-md5-hash
,该插件可以获取到各异步模块的hash
值,然后将这些hash
值与主文件的代码内容一同作为计算hash
的参数,这样就能保证主文件的hash
值会跟随异步模块的修改而修改。但我验证后没有实现。
- 使用
html-webpack-plugin
动态生成html
配置文件中的输出文件都带了[chunkhash]
作为版本号,在style
或js
文件改变时,其值都会随之改变。利用html-webpack-plugin
在webpack
完成前端资源打包以后,自动将打包后的资源路径和版本号写入HTML
中,达到自动化的效果。
点击查看代码
//webpack.production.config.js
var HtmlWebpackPlugin = require('html-webpack-plugin');
...
var config = {
...
plugins:[
...
new HtmlWebpackPlugin({
filename:'view/index.html', //生成的html存放路径,相对于 path
template:'src/view/index.html', //html模板路径
inject:true, //允许插件修改哪些内容,true/'head'/'body'/false,
chunks:['vendors','app'],//加载指定模块中的文件,否则页面会加载所有文件
hash:false, //为静态资源生成hash值
minify:{ //压缩HTML文件
removeComments:false, //移除HTML中的注释
collapseWhitespace:false //删除空白符与换行符
}
}),
new HtmlWebpackPlugin({
filename:'view/mobile.html', //生成的html存放路径,相对于 path
template:'src/view/mobile.html', //html模板路径
inject:true, //允许插件修改哪些内容,true/'head'/'body'/false,
chunks:['vendors','mobile'],//加载指定模块中的文件,否则页面会加载所有文件
hash:false, //为静态资源生成hash值
minify:{ //压缩HTML文件
removeComments:false, //移除HTML中的注释
collapseWhitespace:false //删除空白符与换行符
}
})
]}