深入学习webpack（二）

在深入学习webpack（一）中，我通过一个例子介绍了webpack的基本使用方法，下面将更为系统的学习webpack的基本概念，对于一门技术的掌握我认为系统化还是很重要的，如果仅仅是一知半解，更为深入的地方了解不够，那么你就泯然众人矣。

　　webpack的核心概念主要有四个： entry（入口）、output（出口）、loaders（加载器）、plugins（插件）。下面我将逐一介绍。

Entry

　　webpack会创建应用里所有依赖的图表，而最开始的图表就是所谓的入口文件。入口文件会告诉webpack从何处开始并且根据依赖清楚如何打包。所以入口文件就是承接上下文的根文件或者说是你的app第一个使用的文件。

　　在webpack中我们在 webpack.config.js 中的entry选项里定义入口文件，最简单的定义方式如下：

module.exports = {

  entry: './path/to/my/entry/file.js'

};

　　这个非常容易理解，不再赘述。下面进行更为详细的介绍。

单一入口配置

　　webpack.config.js内容如下：

const config = {

  entry: './path/to/my/entry/file.js'

};

module.exports = config;

　　这和之前的配置是一样的，只是我们把导出的这个对象赋给了config对象之后才导出的。

　　说明：这个语法是虽简单的语法，它是下面语法的简写形式。

const config = {

  entry: {

    main: './path/to/my/entry/file.js'

  }

};

　　 What happens when you pass an array to entry? Passing an array of file paths to the entryproperty creates what is known as a "multi-main entry". This is useful when you would like to inject multiple dependent files together and graph their dependencies into one "chunk".　　

当你希望快速建立一个单入口应用的webpack配置时，这是一个非常棒的选择。然而，这个语法并没有太多的可扩展性。

　注意：这里的main是可以替换的，并且换成任意的名称都是可以编译成功的，但是对于多入口文件，这里的名称就对应于html的名称了，比如两个页面，a.html和b.html，那么在entry中的两个键就是a和b了。

对象语法配置

　　webpack.config.js如下：

const config = {

  entry: {

    app: './src/app.js',

    vendors: './src/vendors.js'

  }

};

　　对象语法可能显得冗杂一些，但是对于定义的入口文件和出口文件这是最具扩展性的方式。

"Scalable webpack configurations" are ones that can be reused and combined with other partial configurations. This is a popular technique used to separate concerns by environment, build target and runtime. They are then merged using specialized tools like webpack-merge.

Scenarios

下面的入口文件的使用是它们在生产环境中使用的例子：

独立的App和Vender入口

webpack.config.js如下所示：

const config = {

  entry: {

    app: './src/app.js',

    vendors: './src/vendors.js'

  }

};

从表面来看，它告诉webpack从app.js和verdors.js两者同时开始（作为入口文件），这些图表是完全独立的，在单页面应用中这是非常常见的（除了verdors）。

多页面应用

const config = {

  entry: {

    pageOne: './src/pageOne/index.js',

    pageTwo: './src/pageTwo/index.js',

    pageThree: './src/pageThree/index.js'

  }

};

与单页面不同，对于多页面显然就有多个入口文件，这样配置的目的就是如此，即告诉webpack我们需要三个独立的依赖图表。

Output

　　即使你需要打包所有的文件到一个文件中你还是需要告诉webpack最终要打包到哪里，而这里的output属性就是告诉webpack如何处理打包文件的。

const path = require('path');

module.exports = {

  entry: './path/to/my/entry/file.js',

  output: {

    path: path.resolve(__dirname, 'dist'),

    filename: 'my-first-webpack.bundle.js'

  }

};

　　同样注意：这里的path时node的内置模块。

　　另外，出口文件的路径必须是绝对路径而不能是相对路径。

　　即我们使用了output.filename和output.path属性来将所有文件最终打包到path和filename对应的文件中去，这样，在html中，我们就可以应用这些文件了。

　　在entry中我们知道入口可以是多个，但是出口文件的配置确实指定的。　

　　下面介绍一些常用的选项，即下面的属性是可以定义在output对象中的。

output.chunkFilename

　　不常用

output.crossOriginLoding

　　与跨域相关。

output.devtoolLineToLine

　　不常用。

output.filename

　　即指定出口文件的文件名，注意：这里不能使用绝对路径，因为output.path选项决定了文件在磁盘上的位置，而filename仅仅是用来命名文件的。

　（1）单入口

{

  entry: './src/app.js',

  output: {

    filename: 'bundle.js',

    path: __dirname + '/build'

  }

}

// writes to disk: ./build/bundle.js

　　即对于单入口的文件，最终只会打包出一个文件。

　（2）多入口

　　当页面是多入口时，你应该使用替换法来确保每一个出口文件都有一个独一无二的名字。

　　其中[name]将会被打包出的文件名所代替。

　　[hash]将会被compilation（编译）所代替。

　　[chunkhash]将会被chunk的hash代替。举例如下所示：

{

  entry: {

    app: './src/app.js',

    search: './src/search.js'

  },

  output: {

    filename: '[name].js',

    path: __dirname + '/build'

  }

}

// writes to disk: ./build/app.js, ./build/search.js

　　注意：这里的app和search对应的页面是app.html和search.html两个。

output.hotUpdateChunkFilename

　　不常用

output.hotUpdateFilename

　　不常用

output.hotUpdateMainFilename

　　不常用

output.jsonpFunction

　　不常用

output.library

　　不常用

output.libraryTarget

　　不常用

output.path

　　这必须是一个绝对路径。如下，config.js：

output: {

    path: "/home/proj/public/assets",

    publicPath: "/assets/"

}

　　index.html:

<head>

  <link href="/assets/spinner.gif"/>

</head>

　　更加复杂的例子是使用CDN。那么config如下：

output: {

    path: "/home/proj/cdn/assets/[hash]",

    publicPath: "http://cdn.example.com/assets/[hash]/"

}

　　注意： path和publicPath是不同的，前者是我们常用的方法，即将模块打包到的路径，而publicPath是为了存放静态资源，如img等。

output.sourceMapFilename

　　不常用

Loaders

　　什么是Loaders？

Loaders are transformations that are applied on the source code of a module.

　　为什么要用Loaders？

　　因为比如我们使用es6的语法，但是现代浏览器不识别，所以在打包前我们就需要使用Loaders将他们进行编译，得到我们想要的结果。

　　这样，通过webpack的Loaders，我们就不需要使用手工的方法去处理这些问题了。

将项目中所有的资源打包是webpack的职责而非浏览器的。 webpack认为所有的文件，包括css、html、scss、jpg等都是模块。然而，webpack只能识别JavaScript。

　　webpack中的Loaders会把你的这些依赖像的文件文件转化为modules。

　　Loaders的意图有两个：

通过test属性识别哪些文件应该被一个确定的Loader转化为模块。
通过use属性来转化这些文件，这样，转化后的模块就可以添加到你的依赖图表中了。

　　如下所示：

const path = require('path');

const config = {

  entry: './path/to/my/entry/file.js',

  output: {

    path: path.resolve(__dirname, 'dist'),

    filename: 'my-first-webpack.bundle.js'

  },

  module: {

    rules: [

      {test: /\.(js|jsx)$/, use: 'babel-loader'}

    ]

  }

};

module.exports = config;

　　上面的配置文件中的modules下就定义了一个rules，且rules是一个数组，其中的每一个元素都是一个对象，配置了Loader。其中，module是说这是我们所需要的模块。

　　它实现了这样的一个功能：

"Hey webpack compiler, when you come across a path that resolves to a '.js' or '.jsx' file inside of a require()/import statement,

use the babel-loader to transform it before you add it to the bundle".

　　即当webpack遇到了js和jsx后缀的文件时，就用babel-loader将其进行编译，然后再打包他们。

　　非常重要的一点是当定义规则时，你是在module.rules下进行定义的，而不是在rules下定义的。

例子

　　比如，我们可以使用loaders来告诉webpack加载一个css文件或者将Typescript转化为js，首先安装下面的loaders：

npm install --save-dev css-loader

npm install --save-dev ts-loader

　　接下来，在webpack.config.js中配置：即将所有的css文件都使用css-loader进行处理，ts同样。

module.exports = {

  module: {

    rules: [

      {test: /\.css$/, use: 'css-loader'},

      {test: /\.ts$/, use: 'ts-loader'}

    ]

  }

};

　　值得注意的是：就css-loader而言，下面的配置也是等效的：

{test: /\.css$/, loader: 'css-loader'}

// or equivalently

{test: /\.css$/, use: 'css-loader'}

// or equivalently

{test: /\.css$/, use: {

  loader: 'css-loader',

  options: {}

}}

　　另外，我们还可以对loader进行配置，配置的方式主要有三种：

通过webpack.config.js
在requires tatement中明确
通过CLI

通过 webpack.config.js

  module: {

    rules: [

      {

        test: /\.css$/,

        use: [

          { loader: 'style-loader'},

          {

            loader: 'css-loader',

            options: {

              modules: true

            }

          }

        ]

      }

    ]

  }

这种方式是最简洁的方式，他可以用来帮助我们维护简洁的代码，并且提供了overview。

通过require

　　通过require或者define来使用loader。并且我们使用！来区分不同的loader，每一部分都是相对于当前的目录。　　

require('style-loader!css-loader?modules!./styles.css');

　　　并且我们可以通过在整个rule之前使用！来覆盖配置中的任何loader。

　　options可以传递一个查询字符串，就像web中的一样？key=value&foo=bar。使用一个JSON对象也是可以的。

通过CLI

webpack --module-bind jade-loader --module-bind 'css=style-loader!css-loader'

　　这里针对于jade文件使用了jade-loader，针对于css文件使用style-loader和css-loader，这种方式无疑非常麻烦的，不建议使用。

Loader的特性

Loaders可以是链式的，即链子上的第一个loader返回一个值作为此链子上的下一个loader需要处理的对象。
loaders可以是同步的，也可以是异步的。
loaders 可以运行在nodejs中。
loaders接受查询字符串。
loaders也可以通过options对象来配置。
plugins可以给loaders更多的特性。

Plugins

　　loaders只能执行一些pre-file的转换，而plugins的功能更为强大，为了使用一个plugin，你必须require()到它，

　　然后再添加到plugins的数组中（一般都要new一个）。

　　注意：因为你可能会多次使用同一个插件因为不同的意图，所以你需要每次都来new；而loader是针对所有的文件的，并且用途是固定的，所以没有new的概念。

　　如下所示：

const HtmlWebpackPlugin = require('html-webpack-plugin'); //installed via npm

const webpack = require('webpack'); //to access built-in plugins

const path = require('path');

const config = {

  entry: './path/to/my/entry/file.js',

  output: {

    path: path.resolve(__dirname, 'dist'),

    filename: 'my-first-webpack.bundle.js'

  },

  module: {

    rules: [

      {test: /\.(js|jsx)$/, use: 'babel-loader'}

    ]

  },

  plugins: [

    new webpack.optimize.UglifyJsPlugin(),

    new HtmlWebpackPlugin({template: './src/index.html'})

  ]

};

module.exports = config;

　　即我们需要先通过npm install来安装到本地，然后在require得到，最后再在plugins中new一个。

　　并且webpack的插件非常多，我们可以在这里查找更多的插件。

插件剖析

　　一个webpack插件就是一个JavaScript对象，它有一个apply属性，这个apply属性被webpack编译器调用，在整个编译的生命周期存在。

配置

　　我们可以通过webpack.config.js进行配置，如下所示：

const HtmlWebpackPlugin = require('html-webpack-plugin'); //installed via npm

const webpack = require('webpack'); //to access built-in plugins

const path = require('path');

const config = {

  entry: './path/to/my/entry/file.js',

  output: {

    filename: 'my-first-webpack.bundle.js',

    path: path.resolve(__dirname, 'dist')

  },

  module: {

    rules: [

      {

        test: /\.(js|jsx)$/,

        loader: 'babel-loader'

      }

    ]

  },

  plugins: [

    new webpack.optimize.UglifyJsPlugin(),

    new HtmlWebpackPlugin({template: './src/index.html'})

  ]

};

module.exports = config;

https://webpack.js.org/concepts/plugins/

努力的人，运气永远都不会太差！