VSCode不自动桥接Node与esbuild，需手动打通PATH、tasks.json和调试器三处：终端启动VSCode确保PATH加载，tasks.json用npx esbuild并设--stdin=off，launch.json指向编译后JS文件且tsconfig.json启用sourceMap。
能配，但别指望“装完插件点一下就通”——Node 环境和 esbuild 是两个独立层，VSCode 本身不自动桥接它们；必须手动打通 PATH、tasks.json 和调试器三处，漏一个就卡在 command not found 或断点不生效。
VSCode 启动时找不到 node 命令
这不是 VSCode 配错了，是它压根没加载你的 shell 初始化文件（比如 ~/.zshrc），PATH 里自然没有 node。
- macOS/Linux：先在终端运行
which node确认路径，再执行code .从终端启动 VSCode（而不是桌面图标） - Windows：检查系统环境变量 PATH 是否包含
C:\Program Files\nodejs\；没加就手动添，或重装 Node.js 并勾选 “Add to PATH” - 验证方式：打开 VSCode 内置终端（
Ctrl + `），直接输node -v—— 输出版本号才算过关，否则别往下配
tasks.json 里跑不起来 esbuild
最常见的是 Command 'esbuild' not found，根本原因不是没装，而是 VSCode 的 task runner 查不到全局命令；更隐蔽的问题是 --watch 卡死无输出，其实是 stdin 被阻塞。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 别用全局安装 +
esbuild命令：改用npx esbuild，它不依赖 PATH，且自动匹配项目node_modules里的版本 - 禁用 stdin：在 tasks.json 的 args 里必须加
--stdin=off，否则--watch模式会静默挂起 - 任务类型设为
"type": "shell"，不是"process"，尤其 Windows 上&&连接符只在 shell 下有效 - 示例最小可用配置：
{ "version": "2.0.0", "tasks": [{ "label": "esbuild:build", "type": "shell", "command": "npx esbuild", "args": [ "--bundle", "--outfile=dist/bundle.js", "--sourcemap", "--stdin=off", "src/index.ts" ], "group": "build", "presentation": { "echo": true, "reveal": "always", "panel": "shared" } }] }
TypeScript + JSX 编译通过但满屏红波浪线
esbuild 能把 .tsx 编译成 JS，但 VSCode 的 TypeScript 语言服务完全不知道你用了什么 JSX 配置，它仍按默认规则校验，于是报 JSX element type does not have any construct or call signatures。
-
tsconfig.json必须设"jsx": "preserve"，让 TS 不处理 JSX，全交给 esbuild - esbuild 命令里显式加
--loader:.tsx=tsx、--jsx-factory=React.createElement、--jsx-fragment=React.Fragment - 如果用了
--define替换环境变量（如--define:process.env.NODE_ENV="development"），记得同步配--define:globalThis.process.env.NODE_ENV="development"，否则 React 开发警告会消失
launch.json 调试时断点不生效
program 字段写错、模块解析模式不匹配、sourceMap 路径不对，这三处任一出错都会让断点变成摆设。
-
program必须指向编译后的.js文件（如dist/server.js），不能指src/server.ts -
tsconfig.json里得有"sourceMap": true，且生成的.js.map和.js在同一目录 - ESM 项目：package.json 必须含
"type": "module"，否则调试器按 CommonJS 解析，import全错 - 加
"cwd": "${workspaceFolder}"显式声明工作目录，避免require('./config')因路径解析失败而报Cannot find module
真正麻烦的从来不是参数本身，而是 VSCode Tasks 对 stdin 和 shell 环境的隐式约束——它不像终端那样“活”，也不像 IDE 插件那样“懂”。配通那一刻很爽，但漏掉 --stdin=off 或少一个 problemMatcher，错误就彻底消失在黑盒里。
