VSCode默认只认PATH中首个node，需在设置中填入which node所得绝对路径并重启，使launch.json中runtimeExecutable自动生效。
确认 Node 可执行文件路径是否被 VSCode 正确识别
VSCode 默认不关心你装了几个 Node 版本，它只认 node 命令在系统 PATH 中的首个匹配项。如果你用 nvm、fnm 或手动切换过 Node 版本，node -v 和 VSCode 调试时看到的版本可能不一致。
- 在终端运行
which node（macOS/Linux）或where node（Windows），记下完整路径，比如/Users/xxx/.nvm/versions/node/v20.15.0/bin/node - 打开 VSCode 设置（
Ctrl+,），搜索Node Executable Path，填入上面拿到的绝对路径 - 重启 VSCode；再进调试面板，点齿轮图标生成
launch.json时，runtimeExecutable字段会自动填入该路径（不是默认的"node"）
launch.json 中启用 V8 引擎高级调试选项
VSCode 的 Node 调试器底层是 Chrome DevTools Protocol（CDP），所有 V8 引擎级能力都靠 runtimeArgs 控制。直接改 launch.json 比依赖插件更可靠。
-
--inspect-brk：启动即断在第一行（比debugger更早），适合调试模块加载逻辑 -
--max-old-space-size=4096：显式限制堆内存上限，避免 OOM 导致调试中断（尤其处理大 JSON 或 Buffer 时） -
--trace-gc或--trace-gc-verbose：输出 GC 日志到调试控制台，配合console.time()定位内存瓶颈 - 不要用
runtimeExecutable: "node-inspect"—— 这个命令已废弃多年，VSCode 1.70+ 后完全由内置调试器接管
示例配置片段：
{
"type": "node",
"request": "launch",
"name": "V8 advanced debug",
"program": "${workspaceFolder}/index.js",
"runtimeArgs": ["--inspect-brk", "--max-old-space-size=4096", "--trace-gc-verbose"],
"skipFiles": ["<node_internals>/**"]
}绕过 Node.js 环境检测，纯 V8 模式运行 JS
某些脚本（如爬虫反调试逻辑、浏览器环境模拟代码）会主动检测 process、globalThis.require 等 Node 特有对象。这时不能靠 vm2 或沙箱库临时打补丁，而要从启动源头隔离。
- 用
node --no-warnings --experimental-repl-await --eval "require('vm').runInNewContext(...)"是错的 —— 仍带完整 Node 上下文 - 正确做法：改用
node --no-warnings --experimental-repl-await --input-type=module -e "/* your code */"，并确保代码里不引用任何 Node 内置模块 - VSCode 中对应配置：把
program改成空字符串，用args传入内联代码，例如："args": ["-e", "console.log(globalThis.process === undefined)"] - 注意：此时
cwd不生效，所有相对路径需转为绝对路径或用import.meta.url构造
调试时看不到 V8 堆快照或 CPU 分析数据
VSCode 调试界面右上角的“捕获堆快照”“开始 CPU 分析”按钮灰掉，不是 UI Bug，而是 V8 的调试协议权限未开启。
- 必须在
launch.json中显式添加"port": 9229（或任意空闲端口），否则 CDP 仅限本地进程通信，不暴露分析接口 - 如果同时运行多个 Node 调试会话，端口冲突会导致分析功能失效 —— 每个配置应设不同
port值 - Chrome 浏览器访问
chrome://inspect时，若列表为空，检查launch.json是否漏了"port"或被防火墙拦截 - Windows 上杀毒软件（如 360、火绒）常静默拦截 9229 端口，临时禁用再试
V8 的堆快照和 CPU 分析数据不会自动保存到磁盘，点击“保存”按钮后生成的是 .heapsnapshot 或 .cpuprofile 文件，这些文件只能用 Chrome DevTools 打开 —— VSCode 自身不解析它们。
