Node.js的ES模块在首次加载后会被缓存，后续再次导入相同路径的模块时会直接返回缓存结果，这一机制虽然提升了模块加载效率，但也导致代码修改后无法即时生效，需要重启进程才能看到更新效果。要实现ES模块的热重载并清除缓存，核心思路是绕过模块的默认缓存逻辑，动态获取最新的模块内容。
ES模块缓存机制原理
Node.js对ES模块的缓存基于模块的URL路径，每个被加载的ES模块都会被存入内部缓存映射中，缓存的键是模块的完整URL。当使用import静态语句导入模块时，Node.js会先检查缓存中是否存在对应路径的模块，如果存在则直接返回缓存的模块实例，不会重新读取文件内容。
静态导入的缓存无法通过常规方式清除，因此要实现热重载，首先需要放弃静态import，改用动态导入语法，因为动态导入每次都会重新解析模块路径，不会完全依赖静态导入的缓存逻辑。
方案一：动态导入实现基础热重载
动态导入使用import()函数，它返回一个Promise，解析结果为模块对象。动态导入不会像静态导入那样被提前解析，每次调用都会重新触发模块的加载流程，不过Node.js仍然会对动态导入的模块做缓存，因此需要额外处理缓存清除。
实现步骤
- 监听模块文件的变化，当文件内容修改时触发重新加载逻辑
- 使用动态导入获取最新的模块内容
- 清除Node.js内部的模块缓存，避免旧模块实例被复用
代码示例
以下是一个基于fs.watch监听文件变化，结合动态导入实现热重载的示例：
import fs from 'fs';
import path from 'path';
import { fileURLToPath } from 'url';
// 获取当前文件的目录路径，适配ES模块
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
// 需要热重载的模块路径
const targetModulePath = path.join(__dirname, 'utils.mjs');
const targetModuleUrl = new URL(`file://${targetModulePath}`).href;
// 清除指定URL的模块缓存
function clearModuleCache(moduleUrl) {
// Node.js的ES模块缓存存储在内部映射中，通过删除对应键实现清除
// 注意：该内部属性可能随Node.js版本变化，生产环境需谨慎使用
if (import.meta._cache) {
delete import.meta._cache[moduleUrl];
}
}
// 动态加载模块的函数
async function loadModule() {
try {
clearModuleCache(targetModuleUrl);
const module = await import(targetModuleUrl);
console.log('模块加载成功，导出内容：', module);
return module;
} catch (err) {
console.error('模块加载失败：', err);
}
}
// 初始加载模块
let currentModule = await loadModule();
// 监听模块文件变化
fs.watch(targetModulePath, async (eventType) => {
if (eventType === 'change') {
console.log('检测到模块文件变化，重新加载...');
currentModule = await loadModule();
}
});
// 模拟调用模块导出函数
setInterval(() => {
if (currentModule && currentModule.default) {
currentModule.default();
}
}, 2000);
上述代码中，clearModuleCache函数尝试清除内部缓存，不过需要注意import.meta._cache是Node.js未公开的内部属性，不同版本可能存在差异，仅适合开发环境使用。
方案二：版本化方案实现稳定热重载
动态导入方案依赖内部缓存的清除，存在兼容性问题，更稳定的方式是采用版本化方案，通过给模块路径添加动态版本参数，让每次导入的模块URL都不同，从而绕过缓存机制。
实现思路
每次需要加载模块时，生成一个唯一的版本标识（比如时间戳、随机数），将其作为查询参数拼接到模块URL后面，这样每次导入的模块URL都是唯一的，Node.js会将其视为全新的模块，不会使用缓存内容。
代码示例
import fs from 'fs';
import path from 'path';
import { fileURLToPath } from 'url';
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);
const targetModulePath = path.join(__dirname, 'utils.mjs');
// 版本化加载模块，每次生成新的URL避免缓存
async function loadModuleWithVersion() {
const version = Date.now(); // 使用时间戳作为版本标识
const moduleUrl = new URL(`file://${targetModulePath}?v=${version}`).href;
try {
const module = await import(moduleUrl);
console.log('版本化加载成功，导出内容：', module);
return module;
} catch (err) {
console.error('版本化加载失败：', err);
}
}
// 监听文件变化触发重新加载
let currentModule = await loadModuleWithVersion();
fs.watch(targetModulePath, async (eventType) => {
if (eventType === 'change') {
console.log('检测到文件变化，版本化重新加载...');
currentModule = await loadModuleWithVersion();
}
});
setInterval(() => {
if (currentModule && currentModule.default) {
currentModule.default();
}
}, 2000);
这种方案不需要操作Node.js的内部缓存，兼容性更好，因为查询参数不同的URL会被视为不同的模块资源，不会命中之前的缓存。不过需要注意，频繁生成新版本会导致旧模块实例无法被及时回收，可能需要额外处理内存释放问题。
两种方案对比
| 方案 | 优势 | 劣势 | 适用场景 |
|---|---|---|---|
| 动态导入+缓存清除 | URL路径固定，便于管理 | 依赖Node.js内部未公开API，兼容性差 | 开发环境临时调试 |
| 版本化方案 | 不依赖内部API，兼容性强 | 会产生大量临时模块实例，需注意内存 | 生产环境热更新、开发环境长期使用 |
注意事项
- 热重载仅适合开发环境或需要动态更新逻辑的场景，生产环境如果频繁热重载可能导致状态不一致问题
- 如果模块有副作用（比如直接执行初始化逻辑），热重载后副作用会再次执行，需要做好幂等处理
- 版本化方案中，旧版本的模块如果还在被引用，不会被垃圾回收，长期运行需要定期清理无引用的模块实例
ES模块的热重载核心在于绕过默认缓存逻辑，动态导入是基础，版本化方案是更稳定的实现方式，开发者可以根据实际需求选择合适的方案。