【webpack】webpack之开发环境中的常用工具

前言

使用开发工具能提高开发效率，但仅用于开发环境，请不要在生产环境中使用它们。

Source map

以追踪错误和警告。
webpack.config.js

const path = require('path');
  const HtmlWebpackPlugin = require('html-webpack-plugin');
  const CleanWebpackPlugin = require('clean-webpack-plugin');

  module.exports = {
    entry: {
      app: './src/index.js',
      print: './src/print.js'
    },
+   devtool: 'inline-source-map',
    plugins: [
      new CleanWebpackPlugin(['dist']),
      new HtmlWebpackPlugin({
        title: 'Development'
      })
    ],
    output: {
      filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

选择一个开发工具

每次编译都要手动运行npm run build，这很麻烦。webpack 中有几个不同的选项，可以帮助你在代码发生变化后自动编译代码：

1.webpack’s Watch Mode
2.webpack-dev-server （在多数场景中使用）
3.webpack-dev-middleware

1.使用观察模式

如果其中一个文件被更新，代码将被重新编译，不必手动构建。
package.json

{
    "name": "development",
    "version": "1.0.0",
    "description": "",
    "main": "webpack.config.js",
    "scripts": {
      "test": "echo \"Error: no test specified\" && exit 1",
 +     "watch": "webpack --watch",
      "build": "webpack"
    },
    "keywords": [],
    "author": "",
    "license": "ISC",
    "devDependencies": {
      "clean-webpack-plugin": "^0.1.16",
      "css-loader": "^0.28.4",
      "csv-loader": "^2.1.1",
      "file-loader": "^0.11.2",
      "html-webpack-plugin": "^2.29.0",
      "style-loader": "^0.18.2",
      "webpack": "^3.0.0",
      "xml-loader": "^1.2.1"
    }
  }

然后npm run watch即可。

缺点：为了看到修改后的实际效果，需要刷新浏览器。

2.使用 webpack-dev-server

提供了一个简单的web服务器，并且能够实时重新加载。

• 安装

npm install --save-dev webpack-dev-server

• 修改配置文件webpack.config.js，告诉开发服务器(dev server)，在哪里查找文件：

const path = require('path');
  const HtmlWebpackPlugin = require('html-webpack-plugin');
  const CleanWebpackPlugin = require('clean-webpack-plugin');

  module.exports = {
    entry: {
      app: './src/index.js',
      print: './src/print.js'
    },
    devtool: 'inline-source-map',
 +   devServer: {
 +     contentBase: './dist'
 +   },
    plugins: [
      new CleanWebpackPlugin(['dist']),
      new HtmlWebpackPlugin({
        title: 'Development'
      })
    ],
    output: {
      filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

• 在package.json中添加 script 脚本，可以直接运行开发服务器(dev server)：

"start": "webpack-dev-server --open"

• 运行npm start，访问localhost:8080即可。Ctrl + c可以退出。

3.使用 webpack-dev-middleware

webpack-dev-middleware 是一个容器(wrapper)，它可以把 webpack 处理后的文件传递给一个服务器(server)。

模块热替换（HMR）

模块热替换(Hot Module Replacement 或 HMR)是 webpack 提供的最有用的功能之一。它允许在运行时更新各种模块，而无需进行完全刷新。

1.启用HMR

• 更新 webpack-dev-server 的配置，使用 webpack 内置的 HMR 插件，删掉print.js的入口起点。

  const path = require('path');
  const HtmlWebpackPlugin = require('html-webpack-plugin');
  const CleanWebpackPlugin = require('clean-webpack-plugin');
 + const webpack = require('webpack');

  module.exports = {
    entry: {
 +      app: './src/index.js',
 +      print: './src/print.js'
 +      app: './src/index.js'
    },
    devtool: 'inline-source-map',
    devServer: {
      contentBase: './dist',
 +     hot: true
    },
    plugins: [
      new CleanWebpackPlugin(['dist']),
      new HtmlWebpackPlugin({
        title: 'Hot Module Replacement'
      }),
 +     new webpack.NamedModulesPlugin(),
 +     new webpack.HotModuleReplacementPlugin()
    ],
    output: {
      filename: '[name].bundle.js',
      path: path.resolve(__dirname, 'dist')
    }
  };

• 修改 index.js 文件，以便当 print.js 内部发生变更时可以告诉 webpack 接受更新的模块。在index.js末尾添加如下代码：

 + if (module.hot) {
 +   module.hot.accept('./print.js', function() {
 +     console.log('Accepting the updated printMe module!');
 +     printMe();
 +   })
 + }

2.HMR修改样式表

• 安装style-loader、css-loader

npm install --save-dev style-loader css-loader

• 更新 webpack.config.js （module中添加）的配置，让这两个 loader 生效

+   module: {
+     rules: [
+       {
+         test: /\.css$/,
+         use: ['style-loader', 'css-loader']
+       }
+     ]
+   },

• src下新建style.css文件

body {
  background: blue;
}

• 在index.js文件中进行导入

  import _ from 'lodash';
  import printMe from './print.js';
+ import './styles.css';

• 将 body 上的样式修改为 background: red;，可以立即看到页面的背景颜色随之更改，而无需完全刷新。

参考文档

《webpack中文文档》