导出拦截器是一种在模块加载时动态劫持并增强导出对象的轻量级模式，适用于Node.js和前端构建环境，无需修改源码即可注入日志、监控等能力，核心是用代理对象替换原始导出。
导出拦截器（Export Interceptor）是一种在模块加载阶段动态劫持并增强导出对象的轻量级模式，适用于 Node.js（CommonJS/ESM）和前端构建环境（如 Webpack、Vite），无需修改原始模块源码即可注入日志、监控、权限校验、缓存等能力。
核心原理：在模块被 require/import 时“中间插一脚”
该模式不修改原模块文件，而是在其被加载的瞬间，用代理对象替换原始导出。关键在于控制模块解析与加载链路：
- CommonJS 下可借助 require.cache 劫持已加载模块，或使用 Module._load 钩子（需谨慎）
- ESM 中可通过 resolve + load 钩子（Node.js 的
--loader）或构建工具的 plugin（如 Vite 插件的transform）实现 - 前端打包场景更常用：在构建时识别目标模块路径，用自定义 wrapper 包裹其导出内容
实战示例：为工具函数库自动添加执行耗时日志
假设你依赖一个第三方模块 lodash-utils，想在不改它代码的前提下，给所有导出函数加上性能打点：
- 在项目中新建
interceptors/lodash-utils.js：
module.exports = new Proxy(original, {
get(target, prop) {
const val = target[prop];
if (typeof val === 'function') {
return function(...args) {
console.time(`[LOG] ${prop}`);
const res = val.apply(this, args);
console.timeEnd(`[LOG] ${prop}`);
return res;
};
}
return val;
}
});
- 后续代码中，把
require('lodash-utils')替换为require('./interceptors/lodash-utils') - 进阶可配合路径别名（Webpack alias / Vite resolve.alias）全局接管，彻底避免手动替换
注意事项与边界限制
该模式灵活但有明确适用边界：
- 仅对模块级导出有效；无法拦截模块内部私有变量或未导出方法
- 若原模块导出的是常量、类、Promise 或静态对象，需按类型定制拦截逻辑（例如 class 需代理 constructor）
- ESM 的
export default和具名导出在构建时处理方式不同，Vite/Webpack 插件需分别匹配export default和export const xxx语法 - 某些框架（如 Next.js）有服务端/客户端双环境，拦截器需确保只在合适环境生效，避免 SSR 报错
替代方案对比：何时选拦截器，何时换其他方式？
导出拦截器适合“读多写少、侵入极低”的增强场景。若需更深度控制，可考虑：
- 运行时装饰器（如 @log）：需源码支持装饰器语法，且仅限类/方法级别
- AST 重写（Babel 插件）：能力最强，但配置复杂、调试成本高，适合统一治理
- Mock 模块（Jest / Vitest）：仅用于测试，不适用于生产增强
- 代理层封装（如创建 utils/index.js 统一导出）：最简单可控，但需团队约定调用入口
