vscode运行node.js卡顿主因是终端缓冲、进程残留和调试配置不当；需加--no-buffered-output参数禁用缓冲、启用killprocessonexit杀子进程、正确配置launch.json并限制scrollback行数。
VSCode 能直接运行 Node.js，但默认终端行为常导致输出延迟、进程残留、调试卡顿——这些问题不是环境没装好，而是终端和 Node.js 的交互机制没调对。
node -v 能跑，但终端输出总滞后几秒
这是典型缓冲区问题：Node.js 在非 TTY 环境（比如 VSCode 终端）下会启用全缓冲，日志攒到一定量才刷出，看着像卡住。
- 临时解决：启动时加
--no-buffered-output参数，例如node --no-buffered-output app.js - 全局生效：在 VSCode 的
settings.json中添加"terminal.integrated.env.windows": {"NODE_OPTIONS": "--no-buffered-output"}（macOS/Linux 用env.osx或env.linux） - 注意：该参数在 Node.js v18.19+ 和 v20.10+ 才原生支持；旧版本需改用
stdbuf -oL -eL node app.js（仅限 Linux/macOS）
关掉终端后 node 进程还在后台跑
VSCode 默认不杀子进程，尤其当你用 npm start 或 node server.js 启动服务时，容易积累僵尸进程，占 CPU 和端口。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 必须开启
"terminal.integrated.killProcessOnExit": true，否则关闭终端只是“视觉退出” - 搭配
"terminal.integrated.confirmOnKill": true，避免误点垃圾桶中断构建任务 - Node.js 代码里别忘了监听信号：用
process.on('SIGINT', () => { server.close(); process.exit(0); })做优雅关闭
调试时断点不生效或 F5 直接报错
不是 launch.json 配置错了，而是 VSCode 没识别到当前文件是可执行的 Node.js 入口——常见于没写 #!/usr/bin/env node 或文件扩展名不是 .js。
- 确保文件以
.js结尾，且首行无 BOM 字符（UTF-8 with BOM 会导致解析失败） - 调试单文件时，推荐用
launch.json的"request": "launch"+"program": "${file}"，而不是依赖自动检测 - 如果用了 ESM（
type: "module"），必须加"runtimeArgs": ["--loader", "ts-node/esm"]（配 ts-node）或确保 Node.js 版本 ≥ v14.13
scrollback 越设越大，VSCode 越卡
把 terminal.integrated.scrollback 设成 100000 行，看似能看更多日志，实则让渲染器持续追踪海量 DOM 节点，内存飙升、滚动迟滞。
- 建议值设为
5000～10000，平衡历史回溯与响应速度 - 长期运行任务（如 watch 构建）务必重定向输出：
npm run dev > dev.log 2>&1，再用 VSCode 打开日志文件查问题 - 终端字体也影响性能：避免用带复杂连字（ligatures）的字体跑高频率日志，Cascadia Code 比 Fira Code 更轻量
真正卡住人的从来不是装不装得上 Node.js，而是终端输出是否实时、进程是否干净、调试是否可信——这些细节不调，项目越大越难排查。尤其是 --no-buffered-output 和 killProcessOnExit，漏掉一个，就可能让本地开发变成猜谜游戏。
