VSCode调试Node.js时的“栈溢出”错误通常是调试器自身序列化失败所致，并非代码真实递归过深；错误源于Electron渲染进程而非Node子进程，关闭Show all frames、禁用autoExpand、限制展开深度可解决。
VSCode 调试 Node.js 时出现多层回调栈溢出（RangeError: Maximum call stack size exceeded），根本不是“栈太小”，而是调试器在展开深层调用链时自身序列化失败或递归逻辑失控——你看到的错误往往发生在 VSCode 渲染进程，而非你的代码真正跑崩了。
为什么 launch.json 里加 --stack-size 没用
V8 早已移除 --stack-size 参数（Node.js ≥18），设了也无效；而 --max-stack-size 是旧版废弃参数，新版直接忽略。你改的其实是调试器启动参数，但真正卡死的是 VSCode 主进程在渲染调用栈时的 JS 引擎（Electron 内置 Chromium），不是 Node 子进程。
-
launch.json中的runtimeArgs只影响被调试的 Node 进程，对调试器 UI 无作用 - 错误堆栈里若含
vscode-js-debug、serializeObject、expandValue等字样，说明是调试器自己爆了 - 强行加大 Node 栈深（如用已删参数）反而会让调试器更早崩溃——它要序列化的帧更多了
Call Stack 面板点开就卡死或崩溃
这是典型调试器序列化溢出：VSCode 尝试把整个嵌套调用链转成 JSON 展示，遇到循环引用、大 Buffer、Proxy 对象或千层嵌套结构时，在主线程递归展开直接触发 Chromium 的 JS 堆限制。
- 打开 Call Stack 面板右上角 “⋯” → 关掉 Show all frames（默认是折叠的，强行展开才出事）
- 在
settings.json中禁用自动展开："debug.inlineValues": false和"debug.javascript.autoExpand": false - 限制对象展开深度：
"debug.javascript.maxNodeModuleSize": 2000（单位 KB，防大模块拖垮序列化） - 别在断点停住时右键点击变量选 Copy Value——尤其含
ArrayBuffer或Uint8Array的对象，瞬间吃光内存
怎么确认是真递归没终止，还是调试器假崩
现象一样，但处理路径完全不同：前者改代码，后者调调试配置。别一上来就怀疑自己的递归逻辑。
- 关掉所有断点，直接跑
node your-script.js—— 如果也报Maximum call stack size exceeded，才是你代码问题 - 如果仅在 VSCode 调试时崩，且错误出现在 DevTools Console 里（不是终端），那就是调试器问题
- 在疑似递归函数第一行加
console.log(`depth: ${n}`)（n 是显式传入的深度计数器），观察日志是否重复、跳变或单调递减后突崩 - 用
process.maxTickDepth（Node.js 20+）查当前 tick 深度，或运行node --v8-options | grep stack看实际栈报告
真实递归过深时该怎么做
补终止条件、加深度守卫、转迭代——这些是必须做的。调试器只是暴露了问题，不是根源。
- 给递归函数加
depth参数，开头写if (depth > 500) throw new Error("Recursion too deep") - 避免隐式闭包捕获大对象：不要在递归函数外定义大数组/对象再被内层函数引用，改用参数传递
- 树遍历类场景优先用栈模拟迭代：
const stack = [root]+while (stack.length) { const node = stack.pop(); stack.push(...node.children) } - 对超深结构（如万层 JSON）改用流式解析（
stream-json）或分块处理，别一次性JSON.parse()
最易被忽略的点：你以为在调代码，其实是在调调试器。Call Stack 面板不是真相，console.log 和裸跑 node 才是基准线。调试器 UI 崩溃 ≠ 你的函数没出口，别被表象带偏节奏。
