热重载调试中断失效八成是缓存/索引/扩展状态错乱所致,应先彻底退出VSCode进程,再精准删除Cache、CachedData及对应工作区的workspaceStorage子目录,禁用search.usePCRE2并配合files.watcherExclude优化监听。

热重载调试中断失效,八成不是代码或配置问题,而是缓存/索引/扩展状态错乱导致的——直接删 Cache、CachedData 和对应工作区的 workspaceStorage 子目录最有效。
热重载卡在“正在编译”或断点不触发,先杀进程再清缓存
VSCode 热重载(如 React Fast Refresh、Vite HMR、Next.js dev)依赖语言服务 + 文件监听 + 缓存索引三者同步。一旦某处缓存损坏,就会出现“改了代码没反应”“控制台不打印新日志”“断点变空心灰显”等现象。
- 必须先彻底退出所有 VSCode 进程:Windows 任务管理器里确认
Code.exe、Code Helper.exe、node.exe(尤其 Remote-WSL 或前端 dev server 场景)全被杀掉;macOS/Linux 用pkill -f "code\|node" - 只清这三处:
%APPDATA%\Code\Cache(Win)、%APPDATA%\Code\CachedData(Win)、%APPDATA%\Code\WorkspaceStorage\(选最近修改日期的子目录) - 别碰
%APPDATA%\Code\User和%USERPROFILE%\.vscode\extensions主目录——否则热重载可能恢复,但你会丢掉 Prettier 格式化规则、GitLens 提交图、甚至登录态
workspaceStorage 里藏着热重载的“记忆”,删错子目录等于重置整个工作区状态
每个打开过的文件夹在 workspaceStorage 下都有一个以哈希命名的子目录,里面存着该工作区的符号索引、搜索快照、调试会话缓存——热重载依赖这些索引判断“哪些模块需要重载”。长期不清理,索引会和实际文件系统脱节。
- 路径示例:
%APPDATA%\Code\WorkspaceStorage\5a7b3e8c1d2f4a5b8c9d0e1f2a3b4c5d\workspace.json(Windows) - 不要全删
WorkspaceStorage,只删你当前出问题项目对应的子目录(按修改时间排序,找最近一次打开该工作区生成的目录) - 删完重启 VSCode,首次热重载会稍慢(重建索引),但之后响应变快;如果删完立刻又涨回几百 MB,说明你开了 Remote-WSL 或用了本地 LLM 插件(如
ms-python.python),它们会在子目录里另建CachedData或model-cache
禁用 search.usePCRE2 能让热重载更“诚实”
启用 PCRE2 正则引擎后,VSCode 有时会复用旧的文件系统快照做增量索引,导致热重载误判“文件未变”,从而跳过重载。这不是 bug,是索引机制的副作用。
- 在
settings.json中加这一行:"search.usePCRE2": false - 必须重启 VSCode(热重载不生效)
- 普通字符串搜索、
^foo.*bar$这类基础正则完全不受影响;只有(?i)、(?m)等高级 PCRE2 特性会失效 - 配合
files.watcherExclude排除**/node_modules/**和**/.git/**,能进一步减少监听抖动干扰热重载
Remote-WSL / Dev Container 场景下,热重载失效要同步清两端缓存
远程容器调试链路中,热重载信号要从本地 VSCode → 容器内 dev server → 容器内语言服务 → 回传 UI。任一端缓存错位都会中断。
- 本地:清
%APPDATA%\Code\Cache+~/.vscode-server/bin(Windows/macOS/Linux 都适用) - 远程(WSL/Container):
rm -rf ~/.vscode-server+killall -u $USER code-server(确保无残留进程) - 容器内若跑的是 Vite/Next.js,额外执行
npm run dev -- --force(强制跳过缓存检查) - 别信 “只清本地就行” —— WSL 的
/home/和容器里的/.vscode-server /root/.vscode-server是两个独立缓存区,漏一个就可能连不上热重载 socket
真正难处理的从来不是“怎么删”,而是删完发现热重载还是慢——这时候大概率是某个扩展(比如 eamodio.gitlens 在大 Git 仓库里解析历史)占着主线程不动,或者 files.watcherExclude 没配对,导致文件监听器持续满载。缓存只是表象,背后永远是资源竞争和路径误配。











