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，错误就彻底消失在黑盒里。