Webpack 4教程 - 第六部分 增强开发时体验

Posted 2021-02-13 葡萄城技术团队

转载请注明出处：葡萄城官网，葡萄城为开发者提供专业的开发工具、解决方案和服务，赋能开发者。
原文出处：https://wanago.io/2018/08/06/webpack-4-course-part-six-increasing-development-experience

 

今天我们将介绍mode属性的development值。它会自动为你配置Webpack以简化开发过程。除此之外，我们还会介绍webpack-dev-server——包括模块热替换。开始吧！

开发体验优化的其中一步是让Webpack运行在watch模式下。试试webpack --watch。现在每当你对源码做出修改，Webpack会重新编译你的工程然后输出。webpack-dev-server则做得更多。它不是把输出文件写到文件夹下，而是直接把它们写入内存。在构建完之后，输出可作为本地服务器资源被访问。

运行 webpack-dev-server

首先是安装它。

npm install webpack-dev-server

 

然后是在你的package.json文件中加入它：

"scripts": {
  "build": "webpack",
  "start": "webpack-dev-server"
}
···

现在就可以使用`npm start`来启动它。你会看到下面的提示信息：
```bash
?wds?: Project is running at http://localhost:8080/

剩下的事情只是在浏览器中打开http://localhost:8080/了。

模块热替换

为进一步优化你的开发体验，可以使用模块热替换，你甚至跳过刷页面的需求。比如，当你对某些样式做了修改，不必刷新整个页面就可以看到效果。

在第四节教程我们曾使用了MiniCssExtractPlugin。请注意，在写文本时，对MiniCssExtractPlugin的热模块更新支持还没有实现。更多信息请可查看Github上的此issue。在当前开发环境，你可能需要使用的是style-loader。

当你运行webpack-dev-server时，它使用与正常构建时相同的配置文件。你可以在webpack.config.js中加入一个叫devServer的参数来进行额外的配置。我们需要它来开启模块热替换。　　

// webpack.config.js
const webpack = require(‘webpack‘);

module.exports = {
  devServer: {
    hot: true
  },
  plugins: [
    new webpack.HotModuleReplacementPlugin()
  ]
};

注意，当开启 -hot 标志以运行 webpack-dev-server 时也会在plugins里加入HotModuleReplacementPlugin。如果你添加了两次，可能会出现问题。

这对于我们的CSS调试是很有吸引力的。但当修改是javascript时，还需点额外步骤。

// index.js
import { divide } from "./divide";

console.log(`6 / 2 = ${divide(6,2)}`);

if(module.hot) {
  module.hot.accept();
}
// divide.js
export function divide(a, b) {
  return a / b;
}

运行module.hot.accept()会让模块可热替换。这同样适用于它引入的所有其他模块。上面的代码意味着，index.js中的accept()让divide模块能够被热替换。

运行module.hot.accept()函数时可以传参，如果你感兴趣，请查看文档。

当使用HotModuleReplacementPlugin插件时，如果输出文件名中使用了chunkhash字段，就可能会出现一些问题。这种情况下，只在开发环境下使用HotModuleReplacementPlugin是个好主意（而且避免使用chunckhash）。

// webpack.config.js
const path = require(‘path‘);
const webpack = require(‘webpack‘);
const htmlWebpackPlugin = require(‘html-webpack-plugin‘);

const isDevServer = require.main.filename.includes(‘webpack-dev-server‘);
const plugins = [
  new HtmlWebpackPlugin({ template: ‘./src/index.html‘ }),
];
if(isDevServer) {
  plugins.push(new webpack.HotModuleReplacementPlugin());
}

module.exports = {
  output: {
    filename: isDevServer ? ‘[name].bundle.js‘ : ‘[name].[chunkhash].bundle.js‘,
    path: path.resolve(__dirname, ‘dist‘),
  },
  plugins,
    devServer: {
      hot: true
  }
}

webpack-serve

译者注：由于webpack-serve其实已经不再维护了。推荐仍然使用上面所说的webpack-dev-sever。

mode: "development"

在之前的课程，我们介绍了mode属性的production值。现在该轮到development了。让我们看看它为我们做了我们。

DefinePlugin

如之前所说，这个插件允许你创建编译时的全局常量。

因为这个插件也在mode: produnction中使用，更多信息可查看教程的第五部分。

这次它的值为process.env.NODE_ENV: JSON。stringify("development")：

module.exports = {
  mode: "development",
  // 使用 mode: "development" 会添加以下配置：
  plugins: [
    new webpack.DefinePlugin({
      "process.env.NODE_ENV": JSON.stringify("development")
    }),
  ]
}

NamedModulesPlugin

这是在使用mode: "development"时默认加入的另一个插件。它在使用模块热替换时很有用。有了NamedModulesPlugin，我们能够看到被替换模块的相对路径。　　

[WDS] App updated. Recompiling...
[WDS] App hot update...
[HMR] Checking for updates on the server...
[HMR] Updated modules:
[HMR]  - ./src/style.css
[HMR] App is up to date

否则我们只会看到一个id，而不是像./src/style.css这样的路径。

NamedChunksPlugin

它的左右和NamedModulesPlugin类似。有了它，不仅模块能看到名字，chunk也能。当应用在浏览器中运行起来是，你可以在window.webpackJsonp属性中查看它们。

使用NamedModulesPlugin和NamedChunksPlugin的一个额外好处是,当添加和删除依赖时，打包不再需要使用模块的顺序id。因为这些id和名字会在最终的输出产物中使用，修改它们会导致文件哈希值的变化，即使这些文件使用的模块本身并没有改变。使用以上两个插件会帮助你处理浏览器的缓存问题。让我们来比较一下代码：

没使用NamedModulesPlugin和NamedChunksPlugin：

// 输出产物
(window["webpackJsonp"] = window["webpackJsonp"] || []).push([[2],{
  /***/ 6:
  (...) // divide.js module output code

  /***/ 7:
  (...) // substract.js module output code
]);

使用了NamedModulesPlugin和NamedChunksPlugin：

(window["webpackJsonp"] = window["webpackJsonp"] || []).push([["utilities~main"],{
  /***/ "./src/utilities/divide.js":
  (...) // divide.js module output code

  /***/ "./src/utilities/substract.js":
  (...) // substract.js module output code
]);

Devtool

除了添加插件，设置mode: "development"还做了一件事，即通过设置devtool的值为eval开启了源码映射（Source Map）。　　

// webpack.config.js
module.exports = {
  mode: "development",
  // 使用 mode: "development:" 添加了以下配置
  devtool: "eval"
}

转译、压缩和打包你的代码能让你的用户有更好的体验。经过这些步骤之后，代码变得更精简和高效。而调试这样的代码则变得非常困难。因此，引入了源码映射（Source Map）。它们把输出后的的代码与源码对应起来。有了它，相对于浏览器真正运行的打包后的输出，你能看到其对应的源码，从而更加容易地使用调试工具和设置断点。我们会在接下来的课程中对源码映射做进一步介绍，但如果你需要现在就定制它，可查看它的文档。　　

总结

Webpack是开发现代Web应用的强大工具。它不仅让你优化生产环境的代码，而且还可以并定制，用以增强开发时的体验。这次我们介绍了如何运行开发时服务器，以及把mode属性设成development的一些作用。我们还学习使用了模块的热替换。所有这些组合起来，能帮你更容易和更快地开发应用。