VSCode卡顿主因是onStartup扩展、node_modules监听过载及调试配置不当；应禁用ESLint等常驻扩展、在.vscode/settings.json中配置files.watcherExclude和search.exclude排除node_modules等目录、launch.json添加skipFiles并禁用autoAttachChildProcesses。
VSCode 跑 Node.js 项目卡、启动慢、调试断点不命中，不是 Node.js 太重，而是默认配置没关掉那些“偷偷干活”的监听和扩展——关对三处，内存降 30%，F5 响应快一倍。
为什么 VSCode 终端里 node -v 报 command not found
根本不是 Node.js 没装好，而是 VSCode 启动时没加载你的 shell 初始化文件（比如 ~/.zshrc 或 ~/.bash_profile），PATH 里压根没 Node.js 路径。
- macOS/Linux：检查
~/.zshrc是否包含export PATH="/usr/local/bin:$PATH"（Homebrew 安装路径）；用 nvm 的话，必须有source ~/.nvm/nvm.sh和nvm use --delete-prefix v18.19.0 - Windows：安装 Node.js 时漏勾了
Add to PATH—— 手动把C:\Program Files\nodejs\加进系统环境变量，然后彻底关闭所有 VSCode 窗口再重开（只关标签页无效） - 验证方式：在 VSCode 内置终端执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出里含 Node.js 安装路径
launch.json 怎么写才不拖慢调试
Node.js 启动时加 --inspect 会开 V8 调试代理，CPU 和内存开销不小，尤其高频函数里设断点更明显。不配 skipFiles 就等于让调试器全程跟踪 node_modules 和底层代码。
OC SSH Tunnel Node Recovery
下载
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
- 必须加：
"skipFiles": ["<node_internals>/**", "node_modules/**/*.js"]</node_internals> - 慎用：
"autoAttachChildProcesses": true—— 子进程一多，调试链爆炸，内存和响应双崩 - ESM 项目（
package.json里有"type": "module"）要加："runtimeArgs": ["--experimental-specifier-resolution=node"] - 别用
runtimeExecutable指向npm或pnpm—— 它们不是 node 进程，调试器没法注入断点
为什么保存文件后 Prettier/ESLint 不自动格式化
三个配置项缺一不可，且必须同时启用，否则就是“看起来开了，实际没跑”。
"editor.formatOnSave": true"editor.codeActionsOnSave": { "source.fixAll.eslint": true }- 项目根目录要有合法的
.eslintrc.js和.prettierrc，且 ESLint 扩展已启用（不是仅安装）
VSCode 卡顿主因：node_modules 监听打爆 inotify 句柄
Linux/macOS 下，VSCode 默认监听整个工作区，node_modules 动辄几万文件，直接耗尽系统 inotify 句柄，导致保存卡、搜索无响应、窗口切换延迟。
- 在项目根目录
.vscode/settings.json中加："files.watcherExclude": { "**/node_modules/**": true, "**/dist/**": true, "**/build/**": true } - 同时加：
"search.exclude": { "**/node_modules": true, "**/dist": true, "**/build": true } - Linux 用户顺手检查：
cat /proc/sys/fs/inotify/max_user_watches，若低于524288，执行：echo 524288 | sudo tee /proc/sys/fs/inotify/max_user_watches
真正轻量的关键不在装多少插件，而在关掉哪些默认开启却没人真用的功能——比如 onStartup 激活的 ESLint、GitLens，还有对 node_modules 的全量监听。这些开关藏得深，但一关一个准。
