Webpack手动实现HMR的两种核心方案解析

作者:构建工坊时间:2026-10-24 12:53:16浏览:122

本文详细解析在Webpack中手动配置模块热替换(HMR)的两种主流方式。首先介绍基于webpack-dev-server的快速实现,利用WebSocket进行双向通信;其次深入讲解webpack-dev-middleware结合webpack-hot-middleware的方案,通过EventSource实现单向通信。文章提供完整的配置代码与原理说明,帮助开发者摆脱脚手架依赖,深入理解热更新机制。

1.前言

在Webpack开发环境中,启用模块热替换(HMR)功能至关重要。它允许应用在运行过程中,无需开发者重新执行npm run dev或刷新浏览器页面,即可实时应用模块更改并展示效果。这一特性显著提升了前端开发的效率与体验。目前,诸如vue-cli、create-react-app等主流脚手架已内置并自动配置了热更新功能,使得开发者无需手动干预即可享受此便利。然而,在特定场景或自定义构建需求下,我们仍需掌握手动配置HMR的方法。本文将重点分享几种手动实现热更新的技术路径。

2.GitHub

GitHub

3.基本配置

为了演示热更新效果,本文基于Vue框架进行开发(其他框架原理类似),首先需搭建基础项目结构并完成必要配置。

项目目录

1.前言 

项目结构如下:build目录下存放Webpack配置文件,src目录包含具体业务代码。

package.json

配置的第一步是安装项目依赖。基础依赖包如下所示:


"devDependencies": {
    "babel-core": "^6.26.3",
    "babel-loader": "^7.1.4",
    "babel-preset-env": "^1.7.0",
    "cross-env": "^5.1.6",
    "css-loader": "^0.28.11",
    "html-webpack-plugin": "^3.2.0",
    "moment": "^2.22.2",
    "vue-loader": "^15.2.4",
    "vue-template-compiler": "^2.5.16",
    "webpack": "^4.11.1",
    "webpack-cli": "^3.0.3",
    "webpack-merge": "^4.1.2"
  },
  "dependencies": {
    "babel-polyfill": "^6.26.0",
    "vue": "^2.5.16"
  }

webpack.config.js

在build目录下创建webpack.config.js作为基础配置文件。通常开发(development)与生产(production)环境的配置存在差异,但部分通用配置可合并以简化代码。该文件内容如下:


const path = require('path');
const webpack = require('webpack');
const package = require('./../package.json');
const VueLoaderPlugin = require('vue-loader/lib/plugin');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const moment = require('moment');
// 设置版本号
const buildVersion = moment().format('YYYY-MM-DD_HH_mm_ss');

module.exports = {
    entry: path.join(__dirname, '../src/pages/main.js'),
    output: {
        path: path.resolve(__dirname, '../dist'),
        publicPath: '/',
        filename: package.name + '.js'
    },
    module: {
        rules:[
            {
                test: /\.vue$/,
                loader: 'vue-loader',
                options: {}
            },
            {
                test: /\.css$/,
                use: [
                    'vue-style-loader',
                    'css-loader'
                ]
            },
            {
                test: /\.js$/,
                loader: 'babel-loader',
                exclude: /node_modules/
            }
        ]
    },
    plugins: [
        new VueLoaderPlugin(),
        new HtmlWebpackPlugin({
            version: buildVersion,
            filename: 'index.html',
            template: path.join(__dirname, '../src/pages/index.html'),
            inject: 'body'
        })
    ],
    externals: {
        'babel-polyfill': 'window'
    },
    devtool: 'source-map'
}

上述配置逻辑清晰,易于理解。

main.js

该文件负责创建Vue实例,作为应用入口。


import 'babel-polyfill'
import Vue from 'vue'

import App from '../container/main.vue'

new Vue({
    el: '#app',
    render: h => h(App)
})

index.html

作为HTML模板,提供页面基础结构。


<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <title>dev-server HRM</title>
    <meta name="robots" content="all" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=0, minimum-scale=1.0, maximum-scale=1.0, viewport-fit=cover"
    />
    <!-- 显示工具栏和菜单栏 -->
    <meta name="apple-mobile-web-app-capable" content="yes" />
    <!-- 工具栏和菜单栏样式 -->
    <meta name="apple-mobile-web-app-status-bar-style" content="black" />
    <!-- 针对手持设备优化,主要是针对一些老的不识别viewport的浏览器,比如黑莓 -->
    <meta name="HandheldFriendly" content="true" />
    <!-- 忽略页面中的数字识别为电话 -->
    <meta name="format-detection" content="telephone=no" />
</head>
<body>
    <div id="app"></div>
</body>
</html>

main.vue

用于测试热加载功能是否生效。

4.webpack-dev-server

webpack-dev-server能够构建本地开发服务器,功能类似小型Express应用,是实现热加载的常用工具。

package.json

安装webpack-dev-server后,需在package.json中配置scripts字段以启动服务。


"scripts": {
  "dev": "cross-env NODE_ENV=development webpack-dev-server --config build/dev.config.js",
   "build": "cross-env NODE_ENV=production webpack-dev-server --config build/build.config.js",
  "test": "echo \"Error: no test specified\" && exit 1"
}

此处使用cross-env实现跨平台环境变量设置,用于区分development或production环境。

dev.config.js

在build目录下新建dev.config.js,专门用于开发环境的Webpack配置。


const webpack = require('webpack')
const config = require('./webpack.config.js')

// webpack4开始需要配置的变量
config.mode = "development";

config.devServer = {
    historyApiFallback:true,
    // hot参数控制更新是刷新整个页面还是局部刷新
    hot: true,
    // inline是热更新的一种模式,另一种是iframe
    inline: true,
    port: 80
}

// 也一定要加上HotModuleReplacementPlugin
config.plugins.push(
    new webpack.HotModuleReplacementPlugin()
)

// 需要导出
module.exports = config;

完成

执行npm run dev命令,修改main.vue文件后,无需刷新浏览器,Webpack会自动打包并更新视图。可通过浏览器控制台Network面板观察WebSocket连接,确认热重载是否启动。

1.前言 

webpack-dev-server通过WebSocket协议向浏览器发送更新信息,实现双向通信。

5.webpack-dev-middleware + webpack-hot-middleware

除webpack-dev-server外,还可采用webpack-dev-middleware配合webpack-hot-middleware实现热重载。由于这两个模块不具备服务器功能,需额外安装Express来启动服务。

package.json

依赖安装完成后,同样需在package.json的scripts字段中配置启动命令。


"scripts": {
  "dev": "cross-env NODE_ENV=development node ./build/dev.config.js",
  "build": "cross-env NODE_ENV=production node ./build/build.config.js",
  "test": "echo \"Error: no test specified\" && exit 1"
},

dev.config.js

采用此方案时,dev.config.js的配置代码相对较多。


const app = require('express')();
const webpack = require("webpack");
const webpackDevMiddleware = require("webpack-dev-middleware");
const webpackHotMiddleware = require("webpack-hot-middleware");
const path = require("path");
let config = require("./webpack.config")

config.mode = "development";

// 灰常重要
config.entry = [config.entry,'webpack-hot-middleware/client'];

config.plugins.push(
    new webpack.HotModuleReplacementPlugin(),
    // 当开启 HMR 的时候使用该插件会显示模块的相对路径,建议用于开发环境
    new webpack.NamedModulesPlugin()
)

const compiler = webpack(config);

// 使用dev-middleware与hot-middleware

const devMiddleware = webpackDevMiddleware(compiler, {
    publicPath: config.output.publicPath,
    quiet: true
})

const hotMiddleware = webpackHotMiddleware(compiler, {
    log: false,
    heartbeat: 2000
})

app.use(devMiddleware);
app.use(hotMiddleware);
app.listen(80);

与webpack-dev-server不同,因所选模块无服务器功能,需手动使用Express开启服务。

完成

执行npm run dev命令,修改main.vue后,无需刷新浏览器,Webpack会自动打包并更新。同样可通过控制台Network面板判断热重载状态。

1.前言 

在此方案中,Webpack使用EventSource与浏览器通信。与WebSocket的双向通信不同,EventSource仅支持从服务器到客户端的单向通信。

至此,关于webpack手动实现HMR的几种方式介绍完毕。如需了解更多webpack HMR相关内容,建议查阅本站历史文章或继续阅读下文。感谢大家的支持!

作者最新文章