在Node.js项目开发中，每次修改代码后都要手动重启进程，随着项目规模变大，启动时间会越来越长，开发体验也随之下降。热加载机制可以解决这个问题：当代码文件发生变化时，自动让新代码在进程内生效，省去重启的等待时间。实现热加载的核心其实就藏在Node.js自带的module模块里，理解它的缓存机制，就能用几十行代码搭建一套属于自己的热加载方案。
一、先搞懂require的缓存机制
Node.js遵循CommonJS规范，每个文件就是一个模块。当我们调用require('./user')时，Node.js内部会经历路径解析、文件定位、编译执行三个步骤，最后把模块的exports对象返回。但很多人忽略了一个关键点：模块在第一次加载后会被缓存起来，后续再require同一个模块时，直接返回缓存中的旧对象，根本不会重新读取文件。
这个缓存就存放在require.cache对象上，它的键是模块的绝对路径（经过path.resolve处理后的完整路径），值是一个Module实例。也就是说，热加载的本质就是：在合适的时机把这个缓存删掉，再重新require一次，新代码就会重新编译执行。
可以通过一个简单的例子验证缓存的存在。先创建两个文件：
// num.js
module.exports = { count: 1 };
// app.js
const num = require('./num');
console.log(num.count); // 1
// 即使此刻手动修改num.js中的count为100，下面这行依然输出1
const num2 = require('./num');
console.log(num2.count); // 1，两次拿到的是同一个缓存对象
console.log(num === num2); // true两次require返回的是同一个对象引用，这就是缓存生效的直接证据。理解了这一点，热加载的实现思路就非常清晰了。
二、利用require.cache手动实现模块重载
最直接的做法是删除缓存再重新加载。由于require.cache是一个普通对象，我们可以用delete操作符移除指定模块的缓存条目：
const path = require('path');
function reload(modulePath) {
const fullPath = path.resolve(modulePath);
if (require.cache[fullPath]) {
delete require.cache[fullPath];
}
return require(fullPath);
}
// 使用示例：重新加载配置模块
const config = reload('./config');
console.log(config);这段代码虽然简单，但有几个细节需要注意。第一，path.resolve必须使用，因为缓存键是绝对路径，直接传相对路径是删不掉缓存的。第二，删除缓存只会影响当前模块，如果其他模块在之前已经拿到了旧的exports引用，它们内部的引用依然指向旧对象，不会自动更新。
针对引用不更新的问题，有一种更彻底的方案：把旧模块缓存中保存的exports对象直接替换为新加载的内容，而不是简单删除：
function hotReload(modulePath) {
const fullPath = path.resolve(modulePath);
const cached = require.cache[fullPath];
if (!cached) {
return require(fullPath);
}
// 读取新模块的导出内容
delete require.cache[fullPath];
const fresh = require(fullPath);
// 把旧引用的内容替换为新内容，让已持有旧引用的代码也能看到变化
Object.keys(cached.exports).forEach(key => {
delete cached.exports[key];
});
Object.assign(cached.exports, fresh);
// 恢复缓存，避免重复加载
require.cache[fullPath] = cached;
return cached.exports;
}这种写法借鉴了Webpack的module.hot思路，通过原地替换exports的属性，让所有持有旧引用的地方都能感知到变化。当然它也有局限：如果旧模块导出的是单个函数或者类的实例，属性替换就不那么可靠了，此时只能依赖外部重新获取引用。
三、监听文件变化，搭建完整的热加载流程
手动重载只是半成品，真正的热加载需要监听文件变化。Node.js提供了fs.watch和fs.watchFile两个API，推荐使用前者，它基于操作系统原生的事件通知，性能更好。把文件监听和缓存清理组合起来，就得到一个完整方案：
const fs = require('fs');
const path = require('path');
const watchers = new Map();
function watchModule(modulePath, onChange) {
const fullPath = path.resolve(modulePath);
if (watchers.has(fullPath)) return;
let timer = null;
const watcher = fs.watch(fullPath, { recursive: false }, () => {
// 防抖：编辑器保存时可能触发多次事件
clearTimeout(timer);
timer = setTimeout(() => {
try {
const mod = hotReload(fullPath);
onChange && onChange(mod);
} catch (err) {
console.error('热加载失败，保留旧版本:', err.message);
}
}, 100);
});
watchers.set(fullPath, watcher);
}
// 使用示例
watchModule('./config.js', config => {
console.log('配置已更新:', config);
});代码中加入了两个工程化处理。一是防抖，编辑器保存文件时往往会连续触发多个change事件，不加防抖会导致模块被重复加载。二是try-catch兜底，如果新代码存在语法错误，重新require会抛异常，捕获后可以保留旧版本继续运行，避免整个进程崩溃，这是生产环境热加载必须考虑的容错逻辑。
如果需要监听整个目录，可以把recursive选项设为true（Windows和macOS支持较好，Linux需要Node较新版本），或者用fs.readdir递归扫描后逐个注册监听。也可以直接遍历require.cache的键，找出某个目录下所有已加载的模块统一清理，实现批量重载。
四、热加载的坑点与成熟工具选择
自研方案虽然灵活，但坑不少。首先是循环依赖问题：模块A依赖B，B又依赖A，删除缓存重载时加载顺序可能错乱，导致拿到的exports是半成品。其次是全局状态丢失，模块内部维护的计数器、连接池、定时器等状态在重载后会归零或重复创建，特别是数据库连接如果不做清理，反复热加载会耗尽连接数。另外，process.mainModule这种进程级引用、以及通过事件回调闭包持有的旧函数，都不会随模块重载而更新。
因此在实践中，建议区分场景选择方案。如果是纯粹的开发期自动重启需求，直接使用nodemon或node-dev这类成熟工具更省心：
npm install -D nodemon nodemon app.js
nodemon的思路是监听变化后重启进程，实现简单可靠，没有状态残留问题。而如果是运行时局部更新需求，比如配置热更新、插件系统、低代码平台的动态脚本，那么基于require.cache的热加载才是正确方向，典型的应用像egg.js的worker热升级、VSCode插件体系，都离不开这套机制。
还有一个容易被忽略的安全点：require.cache上同时挂着模块的children和parent引用链，删除某个模块缓存时，它的父模块缓存中仍保留着对它的依赖记录，某些极端情况下会出现重载不彻底的问题。必要时可以递归清理模块的children：
function deepClean(modulePath) {
const fullPath = path.resolve(modulePath);
const mod = require.cache[fullPath];
if (mod) {
// 先递归清理子依赖
mod.children.forEach(child => deepClean(child.filename));
delete require.cache[fullPath];
}
}总的来说，Node.js的热加载并不神秘，require.cache就是它的命门。掌握缓存清理、引用替换、事件监听这三个核心环节，再结合防抖和容错处理，就能搭建出一套贴合自己业务的热加载机制。开发环境追求省事就用nodemon，运行时需要动态更新就用module模块方案，两者各司其职，才是最合理的技术选型。