VSCode运行npm脚本的前提是系统已正确安装并配置node和npm，需确保终端中node -v和npm -v可用；package.json必须位于项目根目录且scripts字段非空，VSCode通过tasks.json或NPM Scripts面板调用脚本，依赖正确的PATH、Node版本及模块类型（如type: "module"）匹配。
node 和 npm 命令在终端里能用，VSCode 才可能跑起来
VSCode 本身不自带 Node.js 运行时，它只调用系统已安装的 node 和 npm。如果在系统终端（不是 VSCode 内置终端）执行 node -v 或 npm -v 报错，比如 'node' 不是内部或外部命令，那后续所有配置都白搭。
- Windows 安装时务必勾选 Add to PATH；漏了就得手动把
C:\Program Files\nodejs加进系统环境变量Path，加完重启所有终端窗口 - macOS/Linux 用
nvm的，确认source ~/.zshrc（或~/.bash_profile）已写入，并新开终端验证which node能输出路径 - 路径含中文或空格（如
D:\我的项目\nodejs）会导致npm静默失败，尤其 Windows 下极易踩坑
npm init -y 是起点，但 package.json 得配对运行逻辑
npm init -y 只生成骨架，真正让 npm start 或 npm run build 跑起来，得靠 scripts 字段。VSCode 的任务系统和调试器都依赖这个字段里的命令。
- 直接编辑
package.json，在"scripts"里加："start": "node index.js"或"build": "tsc --build" - 如果用 ES Module（写
import），必须加"type": "module"，否则node启动会报ERR_REQUIRE_ESM -
npm run xxx调用的是 shell 命令，所以"build": "echo 'done' && touch dist/built.txt"这种链式命令也合法
VSCode 里运行 npm 脚本，别只靠终端敲命令
内置终端敲 npm start 没问题，但想集成到 VSCode 工作流（比如一键构建+启动），得用 tasks.json 或 launch.json，否则没法绑定快捷键、没法自动捕获错误、也没法和调试联动。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 按
Ctrl+Shift+P（macOSCmd+Shift+P），输Tasks: Configure Task→Create tasks.json from template→npm - 生成的
.vscode/tasks.json里，"script"值填"start"或"build"，对应package.json中的脚本名 - 想让构建失败时中断调试？在
launch.json的"preLaunchTask"字段填上对应 task 名，比如"preLaunchTask": "npm: build"
调试时 npm start 失败？launch.json 配置容易错这三处
VSCode 默认生成的 launch.json 是为单文件调试设计的，直接改 "program" 去跑 npm，不加额外配置就会卡住或没输出。
-
"program"设为"npm"，"args"设为["start"]，不能写成["run", "start"]（npm run是子命令，npm本身不认） - 必须加
"console": "integratedTerminal"，否则npm输出看不到，进程还可能被后台静默杀掉 - 如果脚本里用了
nodemon或ts-node，别往"program"里硬塞——它们不是可直接require的 JS 入口，要用"request": "attach"模式，先命令行启动带--inspect-brk，再连端口
真正麻烦的不是配置项本身，而是 node 版本、模块类型（CommonJS/ESM）、PATH 继承这三层嵌套影响——改一个地方，可能要同步检查另外两个地方是否还匹配。比如改了 type: module，nodemon 启动参数就得加 --exec node --loader ts-node/esm 这类显式 loader 声明，不然直接崩。
