配置Webpack Dev Server 实战操作方法步骤

本文摘要：配置 Webpack Dev Server 可以解决本地开发前端应用时，手动执行 webpack 命令或 yarn build 命令，再去浏览器中访问 dist/index.html 的麻烦耗时操作，可有效简化流程。本文实战演练配置 Webpack Dev Server 的方法与步骤。

在本地开发前端应用时，每次都手动执行 webpack 命令或 yarn build 命令，再去浏览器中访问 dist/index.html 是一件非常麻烦耗时的事情，可以通过配置 Webpack Dev Server 来解决这个问题。实际上 vue-cli 中也配置了 Webpack Dev Server，每次启动 Vue 应用的命令 yarn serve，本质上就是启动 Webpack Dev Server。

webpack-dev-server 官网地址：https://webpack.js.org/configuration/dev-server/

1 安装依赖

由于我们使用的 webpack 版本是当前最新的5.73.0、 webpack-cli 版本是4.9.2， webpack-dev-server 的版本也要使用最新的 4.x:

yarn add webpack-dev-server -D

当前版本为 4.9.3。

2 添加运行命令

在 package.json 文件的 scripts 节点中添加启动 webpack dev server 的命令：

  "scripts": {

    "build": "webpack",

    "serve": "webpack-dev-server"

  },

3 修改 webpack 配置

在 webpack.config.js 中 entry、 plugins、mode 同级新增节点 devServer，基本的配置如下：

// ...

module.exports = {

  // ...

  devServer: {

    port: 9000,

    host: '0.0.0.0',

    hot: true

  },

  // ...

}

该配置表示通过url：http://localhost:9000 来访问应用。除了配置端口、允许访问的 host 外，还可以配置 proxy 实现跨域等。更多配置在上面的官网中查看。

4 启动服务

前面已经在 package.json 中配置了 serve 命令，执行 yarn serve 命令启动 webpack dev server。启动成功后在浏览器中访问 http://localhost:9000 即可访问应用。

注意：

修改了 webpack 的配置（ webpack.config.js）需要重启 webpack dev server 才会生效。

devServer 的配置只对本地开发调试有效，不影响编译打包构建（yarn build）的效果。

5 高效开发的配置

5.1 devtool

默认情况下，如果在 js 代码中通过 console.log 打印日志，或程序报错时，浏览器 console 中输出的内容是经过 webpack 打包编译后的代码位置，如下图所示：

点击上图中的 main.js:21，显示的代码如下：

当代码较多时较难定位问题。可把 devtool 的配置为 source-map ：

// ...

module.exports = {

  // ...

  devServer: {

// ...

  },

  devtool: 'source-map',

  // ...

}

配置后，重启 webpack-dev-server，点击浏览器控制台中输出的 console.log ，会进入源码对应的位置：

source-map 源码映射，webpack 会自动生成源代码与打包构建后的代码的映射关系的文件（xxx.map），通过该映射文件，找到打包构建后的代码对应的源码，从而使浏览器提示源码文件的位置。

5.2 HMR

HMR：Hot Module Replacement 热模块替换。当修改代码时， webpack 默认会将所有模块全部重新打包编译，整个页面重新加载，速度很慢。HMR 热模块替换支持在程序运行中（webpack-dev-server 已启动），修改哪个模块，就自动修改（替换、添加、删除）该模块，需用全部打包所有模块。

上面 devServer 的配置的 hot: true 已经开启了HMR。开启 HMR 后，修改样式整个页面不会刷新，但 JS 不生效。不过在现代化开发中，vue-loader 等实现了 HMR，例如你修改了 vue 的某个组件，保存后只会替换该组件。

今日优雅哥（youyacoder）学习结束，期待关注留言分享~~