在纯 Node.js 环境中调试 CommonJS 模块导出函数，可通过 require 直接调用、在函数内插入 console.log 或 debugger 断点、劫持 require 模拟依赖、或使用 Node REPL 的 .editor/.load 命令实现即写即验的轻量调试。
在无工具链（如 Webpack、Babel、ESM 转译器）的纯 Node.js 环境中，调试 CommonJS 模块里单个独立导出的函数，关键在于绕过模块加载黑盒、直接暴露函数执行上下文，同时保留原始作用域和依赖关系。不需要启动服务或写测试框架，几行代码就能跑起来看结果。
用 require + 直接调用快速验证
假设你有一个 math.js 文件，只导出一个加法函数：
math.jsexports.add = (a, b) => a + b;<br>exports.PI = Math.PI;
你可以新建一个临时调试脚本（比如 debug.js），直接 require 并调用：
立即学习“Java免费学习笔记（深入）”；
const math = require('./math.js');<br>console.log('add(2, 3):', math.add(2, 3)); // 输出 5<br>console.log('PI:', math.PI); // 输出 3.141592653589793
运行 node debug.js 即可看到结果。这种方式不依赖任何构建步骤，适合即写即验。
在函数内部插入 debugger 或 console.log
如果想观察函数执行过程中的中间值，不要只靠外部调用——直接修改源文件，在目标函数里加调试语句：
exports.add = (a, b) => {<br> console.log('输入参数:', { a, b });<br> const result = a + b;<br> console.log('计算结果:', result);<br> return result;<br>};
或者用 debugger 触发断点（需配合 node --inspect）：
exports.add = (a, b) => {<br> debugger;<br> return a + b;<br>};
然后运行：node --inspect-brk debug.js
再打开 Chrome 访问 chrome://inspect → 点击“Open dedicated DevTools for Node”，就能单步调试该函数。
模拟 module.exports 替换以隔离测试
当函数依赖其他模块（比如读取 JSON 配置），又不想引入真实依赖时，可以临时“劫持” require 行为：
// debug.js<br>const Module = require('module');<br>const originalRequire = Module.prototype.require;<br><br>// 拦截对 './config.json' 的 require，返回假数据<br>Module.prototype.require = function (id) {<br> if (id === './config.json') {<br> return { timeout: 5000, retries: 3 };<br> }<br> return originalRequire.call(this, id);<br};<br><br>const myModule = require('./my-service.js');<br>console.log(myModule.doSomething());
这样既保持了 CommonJS 加载逻辑，又避免了文件 I/O 或环境差异干扰调试。
用 REPL 实时交互式调试
Node 自带 REPL，适合探索性调试：
$ node<br>> const m = require('./math.js');<br>{}<br>> m.add(10, 20)<br>30<br>> .editor // 进入多行编辑模式，可写复杂逻辑<br>// 输入函数体后按 Ctrl+D 执行
配合 .load ./debug.js 还能加载本地脚本，实现轻量级沙箱环境。
