在 vite 项目中配置 hmr(热模块替换)通常不需要额外安装插件,因为它是内置功能。默认情况下,vite 会对 javascript、css 和静态资源启用 hmr。若需自定义行为,可在 vite.config.js 中通过 server.hmr 选项修改主机、端口或协议,或通过 optimizedeps 排除未编译的依赖以加速启动。对于特定文件类型,可使用 @vitejs/plugin-react-refresh 等插件增强刷新体验。

如何自定义 HMR 的连接地址和端口?
可以通过修改 vite.config.js 中的 server.hmr 对象来自定义连接参数。例如,设置 host 为 '0.0.0.0' 允许局域网访问,设置 port 为 3000 指定非默认端口。这些配置会直接影响浏览器与 Vite 服务器之间的 WebSocket 通信。

import { defineConfig } from 'vite';
export default defineConfig({
server: {
hmr: {
host: 'localhost',
port: 5173,
protocol: 'ws'
}
}
});运行 npx vite 后,控制台将显示新的 HMR 地址。浏览器开发者工具的 Network 标签页可验证 WebSocket 连接是否成功建立到指定端口。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
如何排除特定依赖以优化 HMR 性能?
当项目引入大型或未编译的 npm 包时,Vite 预构建过程可能变慢,导致 HMR 响应延迟。可通过 optimizeDeps.exclude 数组排除这些包,强制 Vite 直接处理它们或使用其他策略。这能减少首次启动时间和后续更新时的解析开销。

import { defineConfig } from 'vite';
export default defineConfig({
optimizeDeps: {
exclude: ['large-uncompiled-lib']
}
});修改配置后重启开发服务器。观察终端输出,确认 large-uncompiled-lib 不再出现在预构建日志中。HMR 更新速度应有所提升,尤其是在修改引用该库的文件时。
当 HMR 更新失败时如何排查?
HMR 更新失败通常表现为浏览器控制台报错或页面完全刷新而非局部更新。常见原因包括:导入路径错误、模块状态不一致或插件冲突。检查浏览器 DevTools 的 Console 标签,查找 [vite] failed to apply next tick HMR update 类错误。确保所有导入使用相对路径或别名,避免动态导入导致的上下文丢失。若使用 React,确保安装了 @vitejs/plugin-react 并启用了 refresh 选项。

















