WebPack常用功能介绍

最新推荐文章于 2024-09-24 13:06:55 发布

xkdamowang

最新推荐文章于 2024-09-24 13:06:55 发布

阅读量656

点赞数

WebPack常用功能介绍
概述
Webpack是一款用户打包前端模块的工具。主要是用来打包在浏览器端使用的javascript的。同时也能转换、捆绑、打包其他的静态资源，包括css、image、font file、template等。个人认为它的优点就是易用，而且常用功能基本都有,另外可以通过自己开发loader和plugin来满足自己的需求。这里就尽量详细的来介绍下一些基本功能的使用。

安装
npm install webpack
运行webpack
webpack需要编写一个config文件，然后根据这个文件来执行需要的打包功能。我们现在来编写一个最简单的config。新建一个文件，命名为webpack-config.js。config文件实际上就是一个Commonjs的模块。内容如下：

var webpack = require(‘webpack’);
var path = require(‘path’);
var buildPath = path.resolve(__dirname,”build”);
var nodemodulesPath = path.resolve(__dirname,’node_modules’);

var config = {
//入口文件配置
entry:path.resolve(__dirname,’src/main.js’)，
resolve:{
extentions:[“”,”js”]//当requrie的模块找不到时，添加这些后缀
},
//文件导出的配置
output:{
path:buildPath,
filename:”app.js”
}
}

module.exports = config;
我的目录结构是这样的：

var a = require(‘./js/a’);
a();
console.log(‘hello world’);
document.getElementById(“container”).innerHTML = “

hello world

“;
a.js文件内容如下：

module.exports = function(){
console.log(‘it is a ‘);
}
然后我们执行如下的命令：

webpack –config webpack-config.js –colors
这样我们就能在目录里面看到一个新生成的目录build，目录结构如下：

webpack
|—index.html
|—webpack-config.js
|—build
|—app.js
然后引用app.js就Ok啦。main.js和模块a.js的内容就都打包到app.js中了。这就演示了一个最简单的把模块的js打包到一个文件的过程了。

介绍webpack config文件
webpack是根据config里面描述的内容对一个项目进行打包的。接着我们来解释下config文件中的节点分别代表什么意思。一个config文件，基本都是由以下几个配置项组成的。

entry

配置要打包的文件的入口;可以配置多个入口文件，下面会有介绍。

resolve

配置文件后缀名，除了js，还有jsx、coffee等等。除了这个功能还可以配置其他有用的功能，由于我还不完全了解，有知道的朋友欢迎指教。

output

配置输出文件的路径，文件名等。

module(loaders)

配置要使用的loader。对文件进行一些相应的处理。比如babel-loader可以把es6的文件转换成es5。大部分的对文件的处理的功能都是通过loader实现的。loader就相当于gulp里的task。loader可以用来处理在入口文件中require的和其他方式引用进来的文件。loader一般是一个独立的node模块，要单独安装。

loader配置项：

test: /.(js|jsx)$/,//注意是正则表达式，不要加引号，匹配要处理的文件
loader: ‘eslint-loader’,//要使用的loader，”-loader”可以省略
include: [path.resolve(__dirname, “src/app”)],//把要处理的目录包括进来
exclude: [nodeModulesPath]//排除不处理的目录
目前已有的loader列表：

https://webpack.github.io/docs/list-of-loaders.html
一个module的例子:

module: {
preLoaders: [
{
test: /.(js|jsx) $/, loader: ‘eslint-loader’, include: [path.resolve(__dirname, “src/app”)], exclude: [nodeModulesPath] }, ], loaders: [ { test: /.(js|jsx)$ /, //正则表达式匹配 .js 和 .jsx 文件
loader: ‘babel-loader?optional=runtime&stage=0’,//对匹配的文件进行处理的loader
exclude: [nodeModulesPath]//排除node module中的文件
}
]
}
plugins

顾名思义，就是配置要使用的插件。不过plugin和loader有什么差别还有待研究。

来看一个使用plugin的例子：

plugins: [
//压缩打包的文件
new webpack.optimize.UglifyJsPlugin({
compress: {
//supresses warnings, usually from module minification
warnings: false
}
}),
//允许错误不打断程序
new webpack.NoErrorsPlugin(),
//把指定文件夹xia的文件复制到指定的目录
new TransferWebpackPlugin([
{from: ‘www’}
], path.resolve(__dirname,”src”))
]
目前已有的plugins列表：

http://webpack.github.io/docs/list-of-plugins.html
如何压缩输出的文件
plugins: [
//压缩打包的文件
new webpack.optimize.UglifyJsPlugin({
compress: {
//supresses warnings, usually from module minification
warnings: false
}
})]
如何copy目录下的文件到输出目录
copy文件需要通过插件”transfer-webpack-plugin”来完成。

安装：

npm install transfer-webpack-plugin -save
配置:

var TransferWebpackPlugin = require(‘transfer-webpack-plugin’);
//其他节点省略
plugins: [
//把指定文件夹下的文件复制到指定的目录
new TransferWebpackPlugin([
{from: ‘www’}
], path.resolve(__dirname,”src”))
]
打包javascript模块
支持的js模块化方案包括：

ES6 模块

import MyModule from ‘./MyModule.js’;

CommonJS

var MyModule = require(‘./MyModule.js’);

AMD

define([‘./MyModule.js’], function (MyModule) {});

上面已经演示了打包js模块,这里不再重复。ES6的模块需要配置babel-loader来先把处理一下js文件。下面展示下打包ES模块的配置文件:

var webpack = require(‘webpack’);
var path = require(‘path’);
var buildPath = path.resolve(__dirname, ‘build’);
var nodeModulesPath = path.resolve(__dirname, ‘node_modules’);
var TransferWebpackPlugin = require(‘transfer-webpack-plugin’);

var config = {
entry: [path.join(__dirname, ‘src/main.js’)],
resolve: {
extensions: [“”, “.js”, “.jsx”]
//node_modules: [“web_modules”, “node_modules”] (Default Settings)
},
output: {
path: buildPath,
filename: ‘app.js’
},
plugins: [
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
}
}),
new webpack.NoErrorsPlugin(),
new TransferWebpackPlugin([
{from: ‘www’}
], path.resolve(__dirname,”src”))
],
module: {
preLoaders: [
{
test: /.(js|jsx) $/, loader: ‘eslint-loader’, include: [path.resolve(__dirname, “src/app”)], exclude: [nodeModulesPath] }, ], loaders: [ { test: /.js$ /, //注意是正则表达式，不要加引号
loader: ‘babel-loader?optional=runtime&stage=0’,//babel模块相关的功能请自查，这里不做介绍
exclude: [nodeModulesPath]
}
]
},
//Eslint config
eslint: {
configFile: ‘.eslintrc’ //Rules for eslint
},
};

module.exports = config;
打包静态资源
css/sass/less

安装css-loader和style-loader

npm install css-loader –save -dev
npm install style-loader –save -dev
config配置：

var config = {
entry:path.resolve(__dirname,’src/main.js’),
resolve:{
extentions:[“”,”js”]
},
output:{
path:buildPath,
filename:”app.js”
},
module:{
loaders:[{
test:/.css$/,
loader:’style!css’,
exclude:nodemodulesPath
}]
}
}
style-loader会把css文件嵌入到html的style标签里，css-loader会把css按字符串导出，这两个基本都是组合使用的。打包完成的文件，引用执行后，会发现css的内容都插入到了head里的一个style标签里。如果是sass或less配置方式与上面类似。

images

可以通过url-loader把较小的图片转换成base64的字符串内嵌在生成的文件里。安装：

npm install url-loader –save -dev
config配置:

var config = {
entry:path.resolve(__dirname,’src/main.js’),
resolve:{
extentions:[“”,”js”]
},
output:{
path:buildPath,
filename:”app.js”
},
module:{
loaders:[{
test:/.css $/, loader:’style!css’,// exclude:nodemodulesPath }, { test:/.png$ /,loader:’url-loader?limit=10000’}//限制大小小于10k的
]
}
}
css文件内容：

container{

color: #f00;
background:url(images/logo-201305.png);
/*生成完图片会被处理成base64的字符串 注意：不要写'/images/logo-201305.png',否则图片不被处理*/

}
iconfont

内嵌iconfont的使用方法其实和上述处理png图片的方法一致。通过url-loader来处理。

config配置：

var config = {
entry:path.resolve(__dirname,’src/main.js’),
resolve:{
extentions:[“”,”js”]
},
output:{
path:buildPath,
filename:”app.js”
},
module:{
loaders:[{
test:/.css $/, loader:’style!css’,// exclude:nodemodulesPath }, { test:/.(png|woff|svg|ttf|eot)$ /,loader:’url-loader?limit=10000’}//限制大小小于10k的
]
}
}
css文件内容：

@font-face {font-family: ‘iconfont’;
src: url(‘fonts/iconfont.eot’); /* IE9*/
src: url(‘fonts/iconfont.eot?#iefix’) format(‘embedded-opentype’), /* IE6-IE8 */
url(‘fonts/iconfont.woff’) format(‘woff’), /* chrome、firefox */
url(‘fonts/iconfont.ttf’) format(‘truetype’), /* chrome、firefox、opera、Safari, Android, iOS 4.2+*/
url(‘fonts/iconfont.svg#iconfont’) format(‘svg’); /* iOS 4.1- */
}
执行打包后会把字体文件都转换成base64字符串内容到文件里.这里有个头疼的问题，就是每个浏览器支持的字体格式不一样，由于把全部格式的字体打包进去，造成不必要的资源浪费。

打包template
我一大包handlebars的模块为例，来演示下打包模块的过程。有的模板对应的loader，有可能没有现车的，恐怕要自己实现loader。

先安装必须的node模块

npm install handlebars-loader –save -dev
npm install handlebars -save//是必须的
config配置:

var template = require(“./template/tp.html”);
var data={say_hello:”it is handlebars”};
var html = template(data);
document.getElementById(‘tmpl_container’).innerHTML = html;
公用的模块分开打包
这需要通过插件“CommonsChunkPlugin”来实现。这个插件不需要安装，因为webpack已经把他包含进去了。接着我们来看配置文件：

var config = {
entry:{app:path.resolve(__dirname,’src/main.js’),
vendor: [“./src/js/common”]},//【1】注意这里
resolve:{
extentions:[“”,”js”]
},
output:{
path:buildPath,
filename:”app.js”
},
module:{
loaders:[{
test:/.css$/,
loader:’style!css’,
exclude:nodemodulesPath
}
]
},
plugins:[
new webpack.optimize.UglifyJsPlugin({
compress: {
warnings: false
}
}),
//【2】注意这里这两个地方市用来配置common.js模块单独打包的
new webpack.optimize.CommonsChunkPlugin({
name: “vendor”,//和上面配置的入口对应
filename: “vendor.js”//导出的文件的名称
})
]
}
目录结构现在是这样的：

多个入口
config配置：

var config = {
entry:{
m1:path.resolve(__dirname,’src/main.js’),
m2:path.resolve(__dirname,’src/main1.js’)
},//注意在这里添加文件的入口
resolve:{
extentions:[“”,”js”]
},
output:{
path:buildPath,
filename:”[name].js”//注意这里使用了name变量
}
}
webpack-dev-server
在开发的过程中个，我们肯定不希望，每次修改完都手动执行webpack命令来调试程序。所以我们可以用webpack-dev-server这个模块来取代烦人的执行命令。它会监听文件，在文件修改后，自动编译、刷新浏览器的页面。另外，编译的结果是保存在内存中的，而不是实体的文件，所以是看不到的，因为这样会编译的更快。它就想到与一个轻量的express服务器。安装：

npm install webpack-dev-server –save -dev
config配置：

var config = {
entry:path.resolve(__dirname,’src/main.js’),
resolve:{
extentions:[“”,”js”]
},
//Server Configuration options
devServer:{
contentBase: ”, //静态资源的目录相对路径,相对于当前路径默认为当前config所在的目录
devtool: ‘eval’,
hot: true, //自动刷新
inline: true,
port: 3005
},
devtool: ‘eval’,
output:{
path:buildPath,
filename:”app.js”
},
plugins:
new webpack.HotModuleReplacementPlugin(),//这个好像也是必须的，虽然我还没搞懂它的作用
new webpack.NoErrorsPlugin()

}
我的目录结构: