不能直接用 esbuild --watch 在 vscode tasks 里实现 monorepo 热编译，因其默认阻塞 stdin 导致静默挂起，且不识别 workspace 结构；需改用终端独立运行 npx esbuild --watch 并显式指定跨包路径。
不能直接用 esbuild --watch 在 VSCode Tasks 里实现 Monorepo 热编译——它会因 stdin 阻塞静默挂起，且无法跨包监听、不识别 workspace 结构。真要秒级响应，得绕过 Tasks 的限制，用 npx esbuild + --watch + 显式路径组合，在终端独立运行。
为什么 tasks.json 里的 esbuild --watch 总是没反应
VSCode Tasks 默认不分配伪 TTY，而 esbuild --watch 从 v0.19.0 起默认阻塞等待 stdin 输入（哪怕你没输任何东西）。结果就是进程启动后立即挂起：无报错、无输出、CPU 占用几乎为 0，看起来像“假死”。这不是配置写错了，是机制冲突。
- 临时验证：在 VSCode 内置终端执行
source ~/.zshrc（macOS/Linux）或RefreshEnv（PowerShell），再手动跑npx esbuild --watch --sourcemap --outfile=dist/index.js src/index.ts—— 如果能动，就坐实了 stdin 问题 - 长期解法：别把
--watch塞进tasks.json；改用终端常驻命令，配合RunOnSave扩展触发单次构建作补充 - 绝对不要加
"isBackground": true却漏掉"problemMatcher"，否则 TS 错误（如TS2307）会被吞掉，连红波浪线都不显示
Monorepo 下 esbuild 如何跨包监听并正确解析路径
esbuild 本身不理解 pnpm/yarn workspace，--watch 只认文件系统路径。你在根目录跑 npx esbuild --watch，它不会自动扫描 packages/*/src，也不会识别 pnpm link 或 workspace: 协议的依赖。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 必须显式列出所有需监听的源码路径：
--watch=packages/core/src,packages/app/src,packages/cli/src - 入口文件不能写相对路径别名（如
import { foo } from "@myorg/core"），esbuild 默认不解析node_modules/@myorg/core的package.json#exports；得加--bundle --external:@myorg/*或配tsconfig.json的"baseUrl"+"paths"并启用--tsconfig-raw - 如果用
pnpm，确保pnpm build脚本里调的是npx esbuild而非全局esbuild，避免子包 node_modules 里版本不一致
TypeScript + JSX 在 Monorepo 中编译通过但 VSCode 报红波浪线
esbuild 编译成功 ≠ TypeScript 语言服务（TS Server）认可。TS Server 还在按自己规则校验 JSX，而 esbuild 已经把 .tsx 处理成 JS 了，两者脱节。
-
tsconfig.json必须设"jsx": "preserve"，强制 TS 不处理 JSX，全交给 esbuild - esbuild 命令里补全 loader 和 factory：
--loader:.tsx=tsx --jsx-factory=React.createElement --jsx-fragment=React.Fragment - 若用了
--define:process.env.NODE_ENV="development"，务必同步加--define:globalThis.process.env.NODE_ENV="development"，否则 React 开发警告消失，调试时难定位问题
如何让热编译真正“秒级”且不卡住 IDE
所谓秒级，核心是减少中间环节：不走 VSCode Tasks 的 shell 封装，不依赖 language server 的被动刷新，而是让 esbuild 直接监听磁盘变化并写入文件，浏览器或 Node 进程只管读取。
- 前端项目：用
npx esbuild --serve=3000 --sourcemap --watch src/启本地服务，自带热刷新和 sourcemap，比--watch+ 手动 F5 更可靠 - Node 后端：别让 esbuild 直接生成
.js然后被nodemon监听——容易因文件写入时机竞争出错；改用esbuild --outdir=dist --watch输出，再配nodemon --watch dist --ext js,json --exec node dist/index.js - 关键细节：所有路径统一用正斜杠（
packages/app/src），Windows 下反斜杠会导致 esbuild 解析失败；保存文件后务必等编辑器落盘（Ctrl+S），nodemon/esbuild 都只响应磁盘事件，不是编辑器内存状态
最麻烦的从来不是参数怎么写，而是 VSCode 的 Tasks 和终端环境之间那层看不见的隔离——它既不会自动 source 你的 shell 配置，也不给 esbuild 分配 stdin。漏掉 --stdin=off 或少配一个 problemMatcher，错误就彻底沉底。真正生效的配置，往往是在终端里亲手敲出来的那一行 npx esbuild 命令。
