JavaScript 中 CommonJS 怎么在热更新（HMR）开发环境中清除模块缓存-js教程-PHP中文网

在 commonjs 环境中需手动清除 require.cache 实现热更新，因 require 默认永久缓存模块；可通过 require.resolve() 获取绝对路径后删除缓存条目，支持单个或递归清除依赖模块，并配合文件监听实现简易热重载。

javascript 中 commonjs 怎么在热更新（hmr）开发环境中清除模块缓存

在 CommonJS 环境（如 Node.js 服务端开发或某些基于 Webpack 的 SSR/Node 模拟场景）中，热更新依赖于手动清除模块缓存，因为 require 默认会永久缓存模块导出对象。Webpack 的 HMR 主要面向浏览器端，不直接接管 Node.js 的 require.cache；若你在用 nodemon、ts-node-dev 或自研热重载逻辑，就需要主动干预缓存。

为什么需要手动清除 require.cache

Node.js 每次调用 require('./config') 时：

先查 require.cache 中是否存在该模块的绝对路径键
存在则直接返回 module.exports，跳过文件读取与执行
这意味着即使文件已修改，require 仍返回旧对象 —— 热更新失效

如何安全清除单个模块缓存

使用 require.resolve() 获取模块绝对路径，再从缓存中删除对应条目：

const modulePath = require.resolve('./config');
delete require.cache[modulePath];
const config = require('./config'); // 此时重新加载并执行 config.js

注意：require.resolve() 必须传入相对或绝对路径（不能是变量拼接的字符串），否则解析失败；且路径需与最初 require() 时一致（比如都用 ./config，不要混用 ./config.js）。

javascript-pro

专注现代 ECMAScript、异步编程、性能优化和全栈的 JavaScript 专家，适用于现代开发

下载

批量清除多个相关模块缓存

当一个模块依赖其他模块（如 config/index.js → config/db.js），只清主模块不够。可递归清理其所有子依赖：

function clearModuleCache(modulePath) {
  const absPath = require.resolve(modulePath);
  const mod = require.cache[absPath];
  if (mod) {
    // 清除自身
    delete require.cache[absPath];
    // 清除所有被它引用的子模块
    mod.children.forEach(child => {
      delete require.cache[child.id];
    });
  }
}
clearModuleCache('./config');

这个方法能避免因子模块未更新导致的逻辑错乱，适合配置类、路由定义、策略集合等易变模块。