Webpack手动实现HMR的两种核心方案解析
本文详细解析在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框架进行开发(其他框架原理类似),首先需搭建基础项目结构并完成必要配置。
项目目录
项目结构如下: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连接,确认热重载是否启动。
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面板判断热重载状态。
在此方案中,Webpack使用EventSource与浏览器通信。与WebSocket的双向通信不同,EventSource仅支持从服务器到客户端的单向通信。
至此,关于webpack手动实现HMR的几种方式介绍完毕。如需了解更多webpack HMR相关内容,建议查阅本站历史文章或继续阅读下文。感谢大家的支持!
JavaScript插件版本冲突怎么解决?npm安装报错排查
2026-11-03 23:58:39
怎么指定版本下载 pdf.js 旧版资源
2026-11-03 20:56:02
NW.js 应用打包指南:使用 nw-builder 生成多平台安装包
2026-11-03 20:07:02
JS控制台打印样式美化:使用%c自定义日志颜色
2026-11-02 10:29:52
Vue3 + Vite 项目创建与配置指南
2026-11-01 04:02:02
