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

配置 Webpack Dev Server 可以解决本地开发前端应用时，手动执行 webpack 命令或 yarn build 命令，再去浏览器中访问 dist/index.html 的麻烦耗时操作，可有效简化流程。本文实战演练配置 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

即可访问应用。

注意：

1. 修改了 webpack 的配置（

   webpack.config.js

   ）需要重启 webpack dev server 才会生效。
2. 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）学习结束，期待关注留言分享~~