Webpack 快速入门指南（一）

简介

webpack 是一个前端资源加载/打包工具。

webpack 是一个 JavaScript 应用程序的静态模块打包器(module bundler)。当 webpack 处理应用程序时，它会递归地构建一个依赖关系图(dependency graph)，其中包含应用程序需要的每个模块，然后将所有这些模块打包成一个或多个 bundle。

webpack 可以将多种静态资源（js、css、less、sass等） 转换、打包成一个或多个静态文件。

在 webpack 中，"一切皆模块”，它把 js 文件视作模块，其他的（如 css、png、sass 等）文件也视作模块。

webpack 4.0.0 的特性

• CLI 被单独分离到 webpack-cli 包，需单独安装。
• 默认将 ./src/index.js 作为入口，将 ./dist/main.js 作为输出。
• 引入开发（development）和生产（production）模式，必须通过 --mode 选项指定一种模式。
• 移除了一些常用的内置插件，可使用新的内置插件代替。

主要概念

webpack 是高度可配置的，默认的配置文件是 webpack.config.js，你需要先理解四个主要概念：

• 入口（entry）
• 输出（output）
• loader
• 插件（plugins）

入口（entry）

入口 指定了 webpack 应该使用哪个模块，来作为构建其内部依赖图的开始。

进入入口后，webpack 会找出有哪些模块和库是入口起点（直接和间接）依赖的。

每个依赖项随即被处理，最后输出到称之为 bundles 的文件中。

可以通过在 webpack 配置中配置 entry 属性，来指定一个或多个入口起点。

下面是一个 entry 配置的最简单例子：

webpack.config.js

module.exports = {
  entry: './path/to/my/entry/file.js'
};

输出（output）

输出（output）告诉 webpack 在哪里输出它所创建的 bundles，以及如何命名这些文件。

你可以在配置中通过 output 属性进行设定。

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'
  }
};

loader

loader 使 webpack 能够去处理那些非 JavaScript 文件（webpack 自身只理解 JavaScript）。loader 可以将所有类型的文件转换为 webpack 能够处理的有效模块，然后你就可以利用 webpack 的打包功能，对它们进行处理。

loader 能够 import 导入任何类型的模块（例如 .css 文件）。

在 webpack 的配置中 loader 有两个目标：

• test 属性，指定哪些文件需要被 loader 转换。
• use 属性，指定进行转换时，应该使用哪个 loader。

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: /\.txt$/, use: 'raw-loader' }
    ]
  }
};

module.exports = config;

上述示例中，对一个单独的 module 对象定义了 rules 属性，rules 属性里面包含两个必须属性：test 和 use。它告诉 webpack 的编译器：当碰到「require()/import 语句中被解析为 '.txt' 的路径」时，在对它打包之前，先使用 raw-loader 进行转换。

注意： 在 webpack 配置中定义 loader 时，要定义在 module.rules 中，而不是 rules。

插件（plugins）

loader 被用于转换某些类型的模块，而插件则可以用于执行范围更广的任务。

插件的功能包括，从打包优化和压缩，一直到重新定义环境中的变量。

插件接口功能极其强大，可以用来处理各种各样的任务。

想要使用一个插件，你只需要 require() 它，然后把它添加到 plugins 数组中。多数插件可以自定义参数。

const HtmlWebpackPlugin = require('html-webpack-plugin'); // 通过 npm 安装
const webpack = require('webpack'); // 用于访问内置插件
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: /\.txt$/, use: 'raw-loader' }
    ]
  },
  plugins: [
    new webpack.optimize.UglifyJsPlugin(),
    new HtmlWebpackPlugin({template: './src/index.html'})
  ]
};

module.exports = config;

安装

前提条件

在安装 webpack 之前，你必须先安装 node.js，然后通过 node.js 的 npm 工具来安装 webpack。

本地安装

要安装最新版本或特定版本的 webpack ，请运行以下命令之一：

npm install --save-dev webpack

npm install --save-dev webpack@<version>

推荐本地安装。这可以使我们在引入破坏式变更的依赖时，更容易分别升级项目。通常，webpack 通过运行一个或多个 npm 脚本，会在本地 node_modules 目录中查找安装的 webpack：

"scripts": {
    "start": "webpack --config webpack.config.js"
}

说明：当你在本地安装 webpack 后，你能够从 node_modules/.bin/webpack 访问它的 bin 版本。

注意： webpack 4.0.0 中，将 CLI 单独分离到了 webpack-cli 包中，如果想在 CLI 中运行 webpack，就必须单独安装 webpack-cli。

npm install --save-dev webpack-cli

全局安装

npm install --global webpack

npm install --global webpack-cli

初步使用

webpack 用于编译 JavaScript 模块。一旦完成安装，你就可以通过 webpack 的 CLI 或 API 与 webpack 进行交互。