在ESM Node.js项目中使用createRequire如何清除模块缓存并重新加载？

问题原因 #

你的package.json设置了"type":"module"，导致.js文件被Node.js识别为ESM模块。当用createRequire加载ESM模块时，模块缓存不会存入CJS的require.cache，而是存储在ESM专属的缓存系统中。因此你删除require.cache的操作无法清除实际缓存，第二次加载时依然读取缓存，不会重新执行代码。

解决方案 #

方案一：将目标模块改为CJS格式 #

把目标模块改为CJS类型，让require的缓存机制正常生效：

1. 重命名mod.js为mod.cjs（明确标记为CJS模块）
2. 修改testcase.js代码：

import { createRequire } from 'module'
const require = createRequire(import.meta.url)

// 第一次加载CJS模块
require('./mod.cjs')

// 解析模块绝对路径，精准删除缓存
const modCacheKey = require.resolve('./mod.cjs')
delete require.cache[modCacheKey]

// 第二次加载，代码重新执行
require('./mod.cjs')

运行后控制台会打印两次in mod.ts。

方案二：针对ESM模块清除缓存（保留.js扩展名） #

如果必须保留目标模块为ESM类型，可通过动态导入+清除ESM缓存实现：

async function reloadModule() {
  // 第一次加载ESM模块
  await import('./mod.js')

  // 获取模块的绝对URL（ESM缓存的key是模块的绝对URL）
  const modUrl = new URL('./mod.js', import.meta.url).href

  // 清除ESM模块缓存
  delete require.cache[modUrl]

  // 第二次加载，代码重新执行
  await import('./mod.js')
}

reloadModule()

注意：此方法需要在异步函数中执行，因为import()是异步操作。

方案三：绕过模块缓存直接执行代码 #

如果不需要模块系统的依赖管理逻辑，可直接读取文件内容并在当前上下文执行，完全绕过缓存：

import fs from 'fs'
import path from 'path'
import vm from 'vm'

const executeMod = () => {
  // 读取模块文件内容
  const modPath = path.resolve(import.meta.dirname, './mod.js')
  const code = fs.readFileSync(modPath, 'utf8')
  // 在当前上下文执行代码
  vm.runInThisContext(code, { filename: modPath })
}

// 第一次执行
executeMod()
// 第二次执行，不受缓存影响
executeMod()

内容的提问来源于stack exchange，提问作者user29889977