NodeJS自定义Loader问题：CommonJS的require调用无法触发拦截逻辑

Node.js的自定义Loader API（通过--loader参数启用）仅作用于ESM模块的加载流程，CommonJS模块的require调用属于独立的加载机制，不会触发Loader的resolve和load钩子。这是Node.js为保持CommonJS兼容性，将两种模块系统加载逻辑隔离导致的。

针对拦截所有require调用并修改源码的需求，可采用以下两种方案：

方案1：统一使用ESM模块系统 #

将所有模块转为ESM格式，让require调用也通过ESM加载流程处理：

• 在项目根目录的package.json中添加"type": "module"，所有.js文件会被当作ESM处理
• 原CommonJS代码中的require可替换为import，或通过createRequire兼容：

  import { createRequire } from 'module';
  const require = createRequire(import.meta.url);
  const lib = require('./lib.js');
  

这种方式下所有模块加载都会触发你的Loader钩子，是官方推荐的无侵入式方案。

方案2：Monkey Patch拦截CommonJS加载流程 #

若无法转为ESM，可通过修改Node.js内置Module模块，拦截require的解析和加载过程：
在Loader代码或入口文件中添加以下逻辑：

const Module = require('module');

// 拦截模块解析逻辑
const originalResolveFilename = Module._resolveFilename;
Module._resolveFilename = function(specifier, parentModule, isMain) {
  console.log('CommonJS 解析:', specifier);
  // 此处可修改要加载的模块路径
  return originalResolveFilename(specifier, parentModule, isMain);
};

// 拦截模块加载并修改源码
const originalCompile = Module.prototype._compile;
Module.prototype._compile = function(content, filename) {
  console.log('CommonJS 加载:', filename);
  // 示例：替换源码中所有"foo"为"bar"
  const modifiedContent = content.replace(/foo/g, 'bar');
  // 调用原始编译逻辑
  return originalCompile.call(this, modifiedContent, filename);
};

该方式可直接拦截所有require调用的源码，但属于侵入式修改，需注意Node.js版本兼容性。

• 方案1是长期维护的最佳选择，ESM是Node.js的未来发展方向
• 方案2的Monkey Patch可能在Node.js版本更新时出现兼容性问题，需谨慎使用

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