VSCode调试Node报错主因是新版Node（v19+）移除了crypto.createDecipher等旧API，须改用createDecipheriv并确保key/iv为Buffer、显式设置padding；TS断点灰掉因未编译或配置错误，需指向JS文件或用ts-node；await断点无法查看返回值属V8异步机制正常现象。
VSCode 调试 Node 原生 API 报错，基本不是代码写错了，而是你正在用新版 Node（v19+）调用已被移除的旧 API，比如 crypto.createDecipher、http.ClientRequest.prototype.setTimeout（已弃用）或 fs.exists（已废弃）。VSCode 调试器会严格执行当前 Node 版本的规则，不兜底、不兼容。
crypto.createDecipher 等废弃 API 直接报 TypeError: crypto.createDecipher is not a function
Node.js v19 起标记为废弃，v20 默认禁用，v22+ 彻底删除。VSCode 启动的调试进程直接加载当前 Node 运行时，不会降级或 fallback。
-
createDecipher和createCipher必须替换成createDecipheriv/createCipheriv，且参数结构完全不同：key 和 iv 必须是Buffer，不能是字符串 - 旧写法
crypto.createDecipher('aes-256-cbc', keyStr, ivStr)→ 新写法需先Buffer.from(keyStr, 'hex')，并显式调用decipher.setAutoPadding(true) - AES-256 要求 key 长度严格为 32 字节，
Buffer.from('my-key', 'utf8')极大概率出错；推荐用 hex 或 base64 编码密钥 - 如果项目要兼容老系统（如 PHP AES-CBC），注意填充方式（PKCS#7）、编码（UTF-8 vs Latin-1）、IV 传递方式是否一致
launch.json 里 program 指向 .ts 文件但断点灰掉
VSCode 调试器只运行 JS，不编译 TS。哪怕你写了 program: "${workspaceFolder}/src/index.ts"，它也找不到对应 JS 文件，断点自然不绑定。
- 正确做法有两种：
— 编译后调试：确保tsc已运行，program指向"${workspaceFolder}/dist/index.js"，且tsconfig.json中"sourceMap": true和"outDir": "dist"匹配 - — 直接运行 TS：改用
runtimeExecutable: "npx"+runtimeArgs: ["ts-node", "src/index.ts"]，此时sourceMaps仍需开启 - 别漏掉
"type": "node"（全小写），写成"Type"或"pwa-node"在部分 VSCode 版本下会静默跳过配置
调试控制台输 require('fs').readFile 报错或无提示
这不是 Node 没装好，而是 VSCode 没识别出这是 Node.js 上下文——语言服务没加载 @types/node 或项目缺少类型配置。
- 确认项目根目录有
jsconfig.json或tsconfig.json，且"lib"至少含["es2020", "node"] - 运行
npm install --save-dev @types/node（不是@types/nodejs），检查node_modules/@types/node是否存在且非空 - 右下角状态栏确认文件语言模式是
JavaScript或TypeScript，不是Plain Text；误设为JavaScript React也会禁用 Node 核心模块补全 - 按
Ctrl+Shift+P→ 输入TypeScript: Restart TS server强制刷新语言服务，改配置后这步必须做
断点打在 await fetch() 行却看不到返回值
VSCode 在 await 行暂停的位置是 Promise 进入 microtask 队列前，此时 data 还未赋值。这不是 bug，是 V8 异步执行模型决定的。
- 想观察返回值，断点应打在
await下一行（如console.log(data)），这时变量已就绪 - 若必须停在 await 行，右键空白处 →
Add Conditional Breakpoint，填!data或typeof data === 'undefined' - 确保
launch.json中启用了--async-stack-traces（加在runtimeArgs里），否则错误堆栈里根本找不到业务代码位置 - 别依赖 UI 里的“Async stack traces”开关——它只影响局部视图，不改变底层堆栈生成逻辑
最易被忽略的一点：VSCode 调试器从不帮你解决 Node 版本兼容性问题。它只是忠实执行你本地 node 命令对应的运行时行为。查 node -v，看文档改 API，比调配置更重要。
