如何让通过CLI调用的Node.js工具在debugger语句处中断？

针对你开发的类Webpack/Gulp的Node.js CLI工具，无法通过常规node inspect调试的问题，以下是几个可行方案，能让工具在debugger语句处中断排查栈溢出错误：

方法1：直接定位CLI入口文件调试 #

1. 找到工具全局安装后的入口文件路径：

   npm list -g myutil
   

   输出中会显示工具安装目录，找到bin文件夹下的CLI入口文件（比如myutil.js）。
2. 用Node.js调试参数启动该入口文件并带上命令参数：

   node --inspect-brk /path/to/myutil/bin/myutil.js build --mode production
   

3. 打开Chrome浏览器访问chrome://inspect，找到对应的调试目标并点击inspect，就能触发源码中的debugger断点，查看调用栈定位栈溢出原因。

方法2：本地链接工具包+VS Code调试 #

1. 在工具源码目录执行本地链接：

   npm link
   

2. 在测试项目中链接本地工具包：

   npm link myutil
   

3. 在VS Code中创建.vscode/launch.json配置文件，内容如下：

   {
     "version": "0.2.0",
     "configurations": [
       {
         "type": "node",
         "request": "launch",
         "name": "Debug MyUtil CLI",
         "program": "${workspaceFolder}/node_modules/myutil/bin/myutil.js",
         "args": ["build", "--mode", "production"]
       }
     ]
   }
   

4. 启动VS Code调试模式，会自动触发源码中的debugger断点，直接在编辑器中查看调用栈。

方法3：通过NODE_OPTIONS注入调试参数 #

直接在执行CLI命令时添加调试参数，无需定位入口文件：

NODE_OPTIONS='--inspect-brk' myutil build --mode production

执行后终端会输出调试地址，通过Chrome DevTools或VS Code连接调试即可触发断点。

栈溢出排查提示 #

断点触发后，查看调用栈面板，找到重复调用的函数或无限递归逻辑——这通常是RangeError: Maximum call stack size exceeded的根源，无需使用console.log避免终端输出溢出。

内容的提问来源于stack exchange，提问作者Takeshi Tokugawa YD