Node.js安装后node -v报错“不是内部或外部命令”，根本原因是PATH环境变量未包含Node.js安装路径；需确认安装时勾选“Add to PATH”，或手动将安装目录（如C:\Program Files\nodejs）添加至系统Path变量，并新开终端执行where node验证。
node -v 报错“不是内部或外部命令”怎么办
说明 Node.js 没被系统识别，根本原因是 PATH 环境变量没包含 Node.js 安装路径。这不是 VSCode 的问题，而是系统级配置缺失。
- Windows 下安装时务必勾选 “Add to PATH”（新版安装器默认勾选，但手动改过安装路径或静默安装可能跳过）
- 如果已安装但没生效：找到 Node.js 实际安装目录（如
C:\Program Files\nodejs），复制该路径，在系统环境变量Path中新建并粘贴 - 改完后必须新开一个终端（CMD/PowerShell/VSCode 内置终端），旧终端不会自动继承新环境变量
- 验证方式只用一条命令：
where node（Windows）或which node（macOS/Linux），有输出路径才算成功
npm install 为什么总卡在 registry.npmjs.org
国内直连官方源极慢甚至超时，npm install 卡住不是网络问题，是源没切对。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 别用
npm config set registry https://registry.npmjs.org/—— 这是默认源，也是最慢的 - 推荐稳定镜像：
npm config set registry https://registry.npmmirror.com（淘宝源已迁至此） - 临时切换（单次有效）：
npm install express --registry https://registry.npmmirror.com - 检查当前源：
npm config get registry，输出应为https://registry.npmmirror.com - 注意：
.npmrc文件优先级高于全局配置，若项目根目录存在该文件，需一并修改
package.json 里 dependencies 和 devDependencies 到底怎么分
分错会导致生产环境多装一堆没用的包，或构建失败——这不是风格问题，是运行时依赖逻辑。
-
dependencies：运行时必需。比如express、mysql2、lodash。部署到服务器后node app.js要能直接 require 到 -
devDependencies：仅开发阶段需要。比如eslint、jest、typescript、nodemon。上线前执行npm ci --only=production会自动忽略它们 - 安装时加参数决定归属：
npm install express→dependencies；npm install eslint --save-dev→devDependencies - 误装后果：
npm install nodemon不加--save-dev，会导致线上容器启动时多一个无关进程，还可能因权限报错
VSCode 里右键 Run Code 总是跑错文件或报错
Code Runner 插件默认按文件后缀执行命令，对 Node.js 项目来说，它不读 package.json 或 launch.json，纯靠后缀硬匹配。
- 它执行的是
node xxx.js，但如果你当前打开的是test.spec.js或webpack.config.js，直接运行大概率报错 - 真正可靠的运行方式是：在终端里手动执行
npm start（前提是package.json里定义了"start": "node index.js"） - 调试请用 VSCode 原生调试：按
Ctrl+Shift+D→ 点绿色三角 → 选Node.js: Launch Program→ 它会读launch.json配置，支持断点、变量监视、调用栈 - 如果非要右键运行，建议禁用
Code Runner对.js的默认行为，在设置里搜code-runner.executorMap，删掉或注释掉javascript对应项
package.json 的 scripts 字段和 VSCode 的调试配置才是主力，插件只是辅助。很多人卡在“能跑就行”，但包管理混乱、调试走插件、环境不隔离，三个月后就会开始修各种奇怪的依赖冲突。 
