VSCode无法直接调试HTTP/3服务，因Node.js v18.17.0+才实验性支持http3且仅限Linux/macOS，而VSCode调试器不识别--experimental-quic参数和http3协议栈，断点静默失效；必须改用attach模式：终端执行node --inspect=9229 --experimental-quic server.js，再在Chrome DevTools（v124+）中chrome://inspect连接调试。
VSCode 本身不支持直接调试 HTTP/3 服务，因为 Node.js 官方直到 v18.17.0 才实验性引入 http3 模块，且仅限 Linux/macOS，Windows 上仍不可用；更重要的是，VSCode 的内置 Node Debug Adapter 完全不识别 http3 协议栈，断点会静默失效。
Node.js 版本必须 ≥ v18.17.0 且启用 --experimental-quic
HTTP/3 在 Node.js 中属于实验性功能，不是开箱即用。即使你写了 const http3 = require('http3')，不加启动参数会直接报错 Cannot find module 'http3'。
- 必须用
node --experimental-quic server.js启动，否则模块加载失败 -
v20.12.2是当前（2026年）最稳妥的 LTS 版本，v21.x部分预发布版存在 QUIC handshake 超时 bug - macOS 上需确保系统 OpenSSL ≥ 3.0.0（可通过
openssl version验证），旧版会卡在 TLS 1.3 handshake - Linux 用户注意：Ubuntu 22.04 默认 OpenSSL 3.0.2 可用，但 CentOS 7 不支持，别白费时间
launch.json 无法直接 launch http3 服务
VSCode 的 type: "node" 调试器不解析 --experimental-quic 参数，也不理解 http3 模块的内部事件循环机制。你配置 "program": "server.js" 后点击运行，进程会启动，但断点全部失效 —— 这不是你代码写错了，是调试器根本没 attach 到 QUIC 相关的 native 层。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 不要尝试在
runtimeArgs里硬塞--experimental-quic，它会被忽略 -
"request": "launch"模式对http3无效，必须改用"request": "attach" - 正确做法：终端先手动跑
node --inspect=9229 --experimental-quic server.js，再让 VSCode attach -
port必须显式指定（如9229），不能依赖默认值，否则 attach 失败报connection refused
Chrome DevTools 是唯一可靠调试入口
VSCode 对 HTTP/3 的调试支持为零，但 Chrome（v124+）已完整支持 QUIC 调试面板。你得绕过 VSCode，直接用浏览器开发者工具观察连接生命周期。
- 启动服务后访问
chrome://inspect→ 点击Configure...→ 添加localhost:9229 - 刷新页面后，在
Remote Target列表里会出现你的server.js进程（不是网页标签） - 点击
inspect，就能在 Sources 面板设断点、看 call stack、监视http3.ServerRequest实例 - 注意：Chrome 的 Network 面板会显示
h3协议标识，但不会显示 QUIC stream 数据帧，那是chrome://net-internals/#quic的事
真正麻烦的不是怎么写 HTTP/3 服务，而是你怎么确认它真的用了 QUIC —— curl -v --http3 http://localhost:3000 报 HTTP/3 not supported？先检查是否漏了 --http3 参数，再确认服务端监听的是 UDP 端口（不是 TCP），最后翻翻 chrome://net-internals/#quic 里的 handshake 日志。这些细节比断点更关键。
