Vite 开发环境热更新失效的排查：从 HMR 边界到依赖预构建
原创
Vite 开发环境热更新失效的排查：从 HMR 边界到依赖预构建
超哥前端记录
发布于 2026-09-16 10:38:45
发布于 2026-09-16 10:38:45
概述
在维护一个基于 Vite 的中后台项目时，我遇到过几次热更新突然失灵的情况：改完代码浏览器没有反应，控制台里看不到 [vite] hmr update 日志，只能手动刷新才能看到变化。热更新失效不像构建报错那样直接，它往往没有红色错误提示，排查起来更依赖对 Vite 工作机制的理解。常见诱因包括模块被 HMR 边界排除、循环依赖导致更新链断裂、被 optimizeDeps 预构建的依赖没有触发重新
原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。
如有侵权，请联系 cloudcommunity@tencent.com 删除。
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号