node -v 报错“不是内部或外部命令”是因系统path未包含node.js安装路径：windows需检查环境变量path是否含c:\program files\nodejs，macos/linux需确认~/.zshrc中export path正确且source生效。

node -v 报错“不是内部或外部命令”？先盯死 PATH

这不是 VSCode 的问题，而是系统根本找不到 node。安装时没勾选“Add to PATH”或手动改过安装路径，就容易踩这个坑。

• Windows 上检查系统环境变量 Path 是否包含 Node.js 安装目录（如 C:\Program Files\nodejs）
• macOS/Linux 检查 ~/.zshrc 或 ~/.bash_profile 里有没有类似 export PATH="/usr/local/bin:$PATH" 这样的行，且 node 确实装在该路径下
• 别用中文路径装 Node.js —— 某些 npm 包（比如 node-gyp 相关的）会直接编译失败，错误信息常含 gyp ERR! stack Error: spawn ENOENT

launch.json 调试配置里，program 字段写错就断不了点

VSCode 调试器靠 launch.json 里的 program 指向要运行的入口文件。写成相对路径、漏掉 .js 后缀、或指向了未生成的构建产物（比如 dist/index.js 但还没执行 npm run build），都会导致调试启动失败或断点不生效。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 最稳妥写法是用 ${workspaceFolder}/index.js 这类绝对路径变量，避免手输出错
• 如果项目用 TypeScript，program 必须指向编译后的 JS 文件（如 dist/server.js），而不是 src/server.ts
• console 字段建议设为 "integratedTerminal"，方便看到 console.log 和错误堆栈混排输出

装插件不是越多越好，这 3 个是 Node.js 开发刚需

VSCode 插件太多反而拖慢启动和编辑响应。Node.js 工程化开发真正绕不开的只有三个：

• ESLint：必须配合 eslint.config.js 配置规则，否则只报错不修复；推荐启用 eslint.enable 和 editor.codeActionsOnSave 中的 source.fixAll.eslint
• Prettier：和 ESLint 冲突时，用 eslint-config-prettier 关闭 ESLint 的格式化规则，只留 Prettier 做格式统一
• Node Debug Auto-attach（内置）：不用装额外插件，只要在终端运行 node --inspect-brk index.js，VSCode 就能自动连接调试端口

package.json 的 scripts 别只写 "start": "node index.js"

工程化环境里，scripts 是自动化流程的中枢。硬编码路径、忽略环境变量、不区分开发/生产模式，会让协作和 CI 构建踩坑。

• "dev": "node --watch --enable-source-maps index.js" —— --watch 是 Node.js 20+ 原生支持的热重载，比 nodemon 更轻量
• "build": "tsc -p tsconfig.json" 和 "start": "node dist/index.js" 要成对出现，且 dist 目录需加入 .gitignore
• "test": "jest" 如果加了单元测试，务必在 pretest 里加 "build"，确保测的是编译后代码

真实项目里，launch.json 和 package.json 的耦合度比想象中高——改一个就得同步验另一个，否则本地跑得通，CI 就挂。调试器连不上、npm run dev 不热更新、eslint 提示失效，八成是这两处配置没对齐。