根本原因是vscode未继承终端环境变量：macos/linux需启用登录shell（设terminal.integrated.shellargs为["-l"]）并从终端执行code .启动，windows应手动添加node路径至系统path并彻底重启vscode。

VSCode里node命令报“command not found”怎么办

根本原因不是 VS Code 配置错了，而是它没继承你终端里已有的 node 环境。Mac/Linux 用户常因 Shell 初始化文件（如 ~/.zshrc）里配置了 PATH，但 VS Code 启动时没加载它；Windows 用户则多因安装 Node.js 时没勾选“Add to PATH”。

• 先在终端里运行 which node（Mac/Linux）或 where node（Windows），确认路径是否真实存在
• Mac/Linux：在 VS Code 中按 Cmd+Shift+P → 输入 Developer: Reload Window，确保重启后读取最新 Shell 环境；仍不行就从终端启动 VS Code：code .
• Windows：重装 Node.js，务必勾选 Add to PATH；若已安装，手动把 Node.js 安装目录（如 C:\Program Files\nodejs\）加到系统环境变量 PATH 中

调试时提示 “Cannot find runtime 'node'” 或断点不生效

这是 VS Code 的调试器找不到 Node.js 运行时，和终端能跑 node 是两回事——调试器依赖 launch.json 里的 runtimeExecutable 或全局 PATH。

OC SSH Tunnel Node Recovery

诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。

下载

• 检查项目根目录下是否有 .vscode/launch.json，里面 configurations 是否写了 "runtimeExecutable": "/path/to/node"；没写就删掉这行，让它走默认查找逻辑
• 如果用了 nvm / fnm / volta 等版本管理工具，调试器默认不识别它们的切换逻辑；稳妥做法是在 launch.json 中显式指定路径，比如 "runtimeExecutable": "~/.nvm/versions/node/v18.17.0/bin/node"
• 断点不生效常见于用 ts-node 或 esbuild-node 启动 TypeScript 文件，此时应改用 node --loader ts-node/esm 模式，并在 launch.json 中配 "runtimeArgs"

如何一键把旧版 JS（var + function）转成现代语法（const + arrow）

没有“一键全自动无损转换”的通用方案，但可用 jscodeshift + 预设 codemod 实现高可信度批量重构，前提是代码结构清晰、无严重动态执行逻辑（如 eval、new Function）。

• 安装工具：npm install -g jscodeshift，再选一个主流 codemod，例如 https://github.com/cpojer/js-codemorph 提供的 var-to-const 和 function-to-arrow
• 执行前先备份整个项目，然后运行：jscodeshift -t node_modules/js-codemorph/transforms/var-to-const.js src/
• 注意：jscodeshift 不处理作用域嵌套中的 var 提升问题，也不自动修正 this 绑定变化；箭头函数替换后需人工验证回调、定时器、事件监听器等场景
• 更安全的做法是配合 ESLint 规则 no-var 和 prefer-arrow-callback，用 eslint --fix 先做基础修正，再人工 review

自动补全、跳转、类型提示失效（即使 node 能运行）

这不是 Node.js 环境问题，是 VS Code 没识别出项目是 Node.js 项目，或没加载正确的语言服务。TypeScript 和 JavaScript 的智能提示依赖 jsconfig.json 或 tsconfig.json。

• 确保项目根目录有 jsconfig.json（JS 项目）或 tsconfig.json（TS 项目），且含 "type": "module" 或 {"compilerOptions": {"allowJs": true}}，否则 JS 文件不被纳入语言服务
• 禁用所有非必要插件，尤其那些宣称“增强 JS 支持”的第三方插件——VS Code 内置的 JavaScript and TypeScript 语言功能已足够，插件冲突反而导致跳转失败
• 如果用了 exports 字段或 type: "module"，但 jsconfig.json 里没写 "compilerOptions": {"moduleResolution": "nodenext"}，跳转会中断

实际操作中最容易忽略的是：launch.json 和终端环境不是一回事，node 命令能跑 ≠ 调试器能定位；而代码转换看似自动化，实则每处 function 替换都可能改变 this 或 arguments 行为，必须逐模块验证。