起步
在开始学习Webpack
之前,请先确保安装了,建议安装最新版的Node.js。然后就可以使用npm安装Webpack了。你可以将Webpack安装到全局,不过我们通常会把它安装到项目依赖中。
现在进入项目目录,并使用npm init -y
初始化一个默认的package.json。打开终端,键入命令:
//全局安装npm install webpack --g//安装到项目依赖中npm install webpack --save-dev
安装好Webpack依赖后,新建一个webpack.config.js文件,用来配置webpack。不过在配置webpack之前,先安装webpack-dev-server
:
//全局安装npm install webpack-dev-server --g//安装到项目依赖中npm install webpack-dev-server --save-dev
webpack-dev-server
它将在localhost:8080启动一个express静态资源web服务器,并且会以监听模式自动运行webpack,在浏览器打开或可以浏览项目中的页面和编译后的资源输出,并且通过一个socket.io服务实时监听它们的变化并自动刷新页面。
在终端中执行webpack-dev-server --inline --hot
当我们修改了模块的内容后,webpack-dev-server
会自动执行打包(打包后的结果会缓存到内存中,所以不能在本地文件中看到打包后的文件)。
inline
选项为整个页面添加了"Live Reloading"功能,而hot
选项开启了"Hot Module Reloading"功能,这样就会尝试着重载发生变化的组件,而不是整个页面。这样就实现了修改文件,界面就会自动更新了。
package.json
中输入以下内容: "scripts": { "dev": "webpack-dev-server --colors --hot --inline", "build": "webpack --colors --watch" },
这样我们只需要键入npm run dev
命令就能执行上面的命令了。
在这之前,先看看项目的结构以及一个简单的webpack config
:
|——hello-webpack |——src # 项目源码 |——assets # 资源文件 |——img # 图片 |——css # 样式 |——component # 页面组件 main.js # 入口文件 |——static # 静态资源文件 index.html package.json webpack.config.js
webpack config.js:
var path = require('path');var webpack = require('webpack') var HtmlWebpackPlugin = require('html-webpack-plugin') module.exports = { entry: { app: './src/main.js' }, output: { path: path.resolve(__dirname, './dist'), publicPath: '', filename: '[name].js' }, resolve: { extensions: ['', '.js', '.jsx', '.json'], alias: { 'src': path.resolve(__dirname, './src'), 'assets': path.resolve(__dirname, './src/assets'), 'components': path.resolve(__dirname, './src/components') } }, module: { loaders: [ { test: /\.js|jsx?$/, exclude: /node_modules/, loader: 'babel', query: { presets: ['es2015', 'react'] } }, { test: /\.css$/, loader: 'style!css', exclude: /node_modules/ }, { test: /\.(png|jpe?g|gif|svg)(\?.*)?$/, loader: 'url', query: { limit: 10000, name: path.join('static', 'img/[name].[hash:7].[ext]') } } ] }, plugins: [ new HtmlWebpackPlugin({ filename: 'index.html', template: 'index.html', inject: true }), ] }
Webpack配置
webpack.config.js为Webpack的默认配置,我们可以为开发环境和生产环境分别做不同的配置。下面一一介绍每个配置的作用。
entry
entry
是入口配置项,可以是string
,Array
或者一个Object
:
entry: { app: './src/main.js'},
entry: './src/main.js'
如果页面有多个入口可以这样写:
entry: ['./src/home.js', '.src/profile.js']//或entry: { home: './src/home.js', profile: './src/profile.js' }
output
output
是输出配置。
output: { path: path.resolve(__dirname, './dist'), publicPath: '/', filename: '[name].js', chunkFilename: '[id].[hash].js' }
path是文件输出到本地的路径,publicPath是文件的引用路径,可用来被一些Webpack插件用来处理CSS,HTML文件中的URL,一般用于生产模式,filename是打包后的入口文件名,chunkFilename是每个模块编译后的文件名,其中[hash]是用来唯一标识文件,主要用来防止缓存。
path
仅仅用来告诉Webpack在哪里存放结果文件,上面例子中,最终的打包文件会放到与当前脚本文件同级目录的dist目录下。即:
hello-webpack +dist -webpack.config.js
filename
入口文件打包后的名称,[name]
对应着入口文件的key值,例如:app.js
,这对多入口文件是很有用的,应为入口文件可以有多个,但是filename只能有一个,所以对于上面的多入口,最后就是:home.js
,'profile.js',当然为了体现文件层级关系可以这么写:
filename: 'js/[name].js'
最后的结果就是:
|——hello-webpack |——dist |——js home.js profile.js webpack.config.js
chunkFilename
即非入口文件打包后的名称,未被列在entry中,却又需要被打包出来的文件命名配置。一般情况下是不需要这个配置的。比如我们在做异步加载模块时就需要用到了:
Vue.component('async-webpack-example', function (resolve) { // 这个特殊的 require 语法告诉 webpack // 自动将编译后的代码分割成不同的块, // 这些块将通过 Ajax 请求自动下载。 require(['./my-async-component'], resolve) })
publicPath
文件的引用路径,可用来被一些Webpack插件用来处理CSS,HTML文件中的URL,在开发模式下建议使用相对路径,在生产模式中,如果你的资源文件放在别的服务器上,可以使用服务器的地址。当然你也可以不用配置publicPath
,。
url-loader
加载图片, { test: /\.(png|jpe?g|gif|svg)(\?.*)?$/, loader: 'url', query: { limit: 10000, name: path.join('static', 'img/[name].[hash:7].[ext]') # 图片最终的输出路径 }}
在main.js
中使用了图片
import Girl from 'assets/img/girl.jpg'
那么最终浏览器访问的图片路径就是:
static/img/girl.7672e53.jpg
所以可以根据开发环境和生产环境配置不同的publicPath
。
output
: output: { path: path.resolve(__dirname, './dist'), publicPath: './', filename: 'js/[name].[chunkhash].js', chunkFilename: `js/[id].[chunkhash].js` }
那么最终打包后的输出目录结构就是这样的:
|——dist |——static |——img girl.7672e53.jpg |——js app.js index.html
所以通过static/img/girl.7672e53.jpg
可以访问到图片。在开发环境下,经过测试,将publicPath
设置为'./'界面是无法加载出来的,所以在开发环境下可以不用设置。
loader
module: { loaders: [ { test: /\.js|jsx?$/, exclude: /node_modules/, loader: 'babel', query: { presets: ['es2015', 'react'] } }, { test: /\.css$/, loader: 'style!css', exclude: /node_modules/ }, { test: /\.(png|jpe?g|gif|svg)(\?.*)?$/, loader: 'url', query: { limit: 10000, name: path.join('static', 'img/[name].[hash:7].[ext]') } } ] }
由于Webpack本身只能处理JavaScript 模块,如果要处理其他类型的文件,就需要使用loader 进行转换。Loader可以理解为是模块和资源的转换器,它本身是一个函数,接受源文件作为参数,返回转换的结果。不同的loader可以将各种类型的文件转换为浏览器能够接受的格式如JS,Stylesheets等等。
下面一一对这些子参数进行说明:
test
参数用来指示当前配置项针对哪些资源,当参数匹配时,就会使用相应的loader。exclude
参数用来剔除掉需要忽略的资源。include
参数用来表示本loader配置仅针对哪些目录/文件,从名称上就可以认为跟exclude
作用相反。loader/loaders
参数,用来指示用哪个/哪些loader来处理目标资源,这俩表达的其实是一个意思,只是写法不一样,我个人喜欢将loader写成一行,多个loader间使用!分割,这种形式类似于管道的概念,例如loader: 'css?!postcss!less'
,可以很明显地看出,目标资源先经less-loader处理过后将结果交给postcss-loader作进一步处理,然后最后再交给css-loader。
loader本身也是可以配置的,传入不同的参数可以实现不同的功能。以为例,我们配置url-loader使小于10000字节的图片使用DataURL,大于10000字节的图片使用URL,name
属性配置输出图片的图片名称,例如:
require('a.png') => static/a.3445645.png
不同的loader配置参数不一样,具体配置参数可以去官网查看。
loader链
多个loader可以链式调用,作用于同一种文件类型。工作链的调用顺序是从右向左,各个loader之间使用"!"分开。
以处理css文件为例,我们需要来处理css文件,然后使用将css样式插入到html的style
标签中。 plugin
插件可以完成更多loader不能完成的功能。
插件的使用一般是在webpack的配置信息plugins选项中指定。loader是在打包前或打包的过程中作用于单个文件。plugin通常在打包过程结束后,作用于包或者chunk级别。以下是一些常用的插件:
-
ExtractTextPlugin的作用是把各个chunk加载的css代码合并成一个css文件并在页面加载的时候以
<link>
的形式进行加载。var ExtractTextPlugin = require('extract-text-webpack-plugin')module: { loaders: [ { test: /\.css$/, loader:ExtractTextPlugin.extract("style-loader","css-loader") } ] }, plugins: [ new ExtractTextPlugin(path.join('static', 'css/[name].[contenthash].css')) ]
注意:如果想要把CSS放到HTML的style标签中,可以不使用extract-text-webpack-plugin,只要用css-loader和style-loader就可以了。
-
html-webpack-plugin,是用来生产html的,其中filename是生产的文件路径和名称,template是使用的模板,inject是指将js放在body还是head里。为
true
会将js放到body里new HtmlWebpackPlugin({ filename: 'index.html', template: 'index.html', inject: true }),
这个插件是建议一定要安装的。
-
uglifyJSPlugin
uglifyJSPlugin是将代码进行压缩的。
new webpack.optimize.UglifyJsPlugin({ compress: { warnings: false } })
-
CommonsChunkPlugin
CommonsChunkPlugin是将多个入口文件之间共享的块打包成一个独立的js文件。至此,你只需要在每个页面都加载这个公共代码的js文件,就可以既保持代码的完整性,又不会重复下载公共代码了。
new webpack.optimize.CommonsChunkPlugin({ name: 'vendor', filename: '[name].[chunkhash].js', minChunks: 4 })
name
,给这个包含公共代码的chunk命个名(唯一标识)。filename
,如何命名打包后生产的js文件。minChunks
,公共代码的判断标准:某个js模块被多少个chunk加载了才算是公共代码。chunks
,表示需要在哪些chunk(也可以理解为webpack配置中entry的每一项)里寻找公共代码进行打包。不设置此参数则默认提取范围为所有的chunk。
resolve
resolve: { extensions: ['', '.js', '.jsx', '.json'], alias: { 'src': path.resolve(__dirname, './src'), 'assets': path.resolve(__dirname, './src/assets'), 'components': path.resolve(__dirname, './src/components') } }
resolve.extensions
是对模块后缀名的简写,配置后,原本是require('./components/app.jsx')
可以简写为require('./components/app')
。
resolve.alias
是别名,配置后,比如原本是require('./src/components/nav.jsx')
可以简写为require('components/nav.jsx')
。
Webpack中的hash与chunkhash
hash与chunkhash
按照官方的定义hash
就是webpack的每一次编译(compilation)所产生的hash值,chunkhash
从字面上理解就是每一个chunk
的hash值。那么什么时候会产生编译以及chunk
又是什么东西?
compilation
compilation
对象代表某个版本的资源对应的编译进程。当使用Webpack的development中间件时,每次检测到项目文件有改动就会创建一个compilation,进而能够针对改动生产全新的编译文件。以及在每次执行webpack
命令时都会创建一个compilation。也就是说当创建了一个compilation,我们所有需要打包的文件(js,css,img,font等)都会产生相同的hash。
如果在项目中我们使用hash作为编译输出文件的hash的话,像这样:
entry: { home: './src/home.js', profile: './src/profile.js' }, output: { path: './dist', filename: 'js/[name].[hash].js' }
那么在编译后所有的文件名都会使用相同的hash值,这样带来的问题是,上面两个js文件任何一个改动都会影响另外文件的最终文件名。上线后,另外文件的浏览器缓存也全部失效。这肯定不是我们想要的结果。
那么如何避免这样的问题呢?
答案就是使用chunkhash
。
chunkhash
是每一个chunk
的hash值,chunk
就是模块(webpack中一切皆模块),chunkhash
也就是根据模块内容计算出的hash值。所以某个文件的改动只会影响它本身的hash值,不会影响其他文件。所以可以将上面的filename改为: filename: 'js/[name].[chunkhash].js'
这样的话每个文件的hash值都不相同,上线后无改动的文件不会失去缓存。
不过使用chunkhash
也不能解决所有问题,比如打包css
文件。
js与css共用相同chunkhash的解决方案
前文提到了webpack的编译理念,webpack将style视为js的一部分,所以在计算chunkhash
时,会把所有的js代码和style代码混合在一起计算。所以,不论是修改了js代码还是css代码,整个chunk的内容都改变了,计算所得的chunkhash自然就一样了。
那么如何解决这种问题呢?
contenthash
webpack默认将js/style文件统统编译到一个js文件中,可以借助将style文件单独编译输出。所以我们可以这样配置:
new ExtractTextPlugin('./dist/css/[name].[contenthash].css')
contenthash
代表的是文本文件内容的hash值,也就是只有style文件的hash值。这样编译输出的js和css文件将会有其独立的hash值。
示例代码
在看文章的同时,搭配会更直观哦,赶紧动起手来,开始入坑Webpack吧:)。
克隆后,请执行 npm install
//启动运行环境npm run dev //执行打包npm run build