VSCode 中 Node.js 无法原生调试 HTTP/3，因 v20.12+ 实验性 QUIC 需 --experimental-quic 启动，但 VSCode 调试器不支持该 flag，且浏览器 localhost 默认禁用 HTTP/3，工具链断层导致调试不可行。
VSCode 里 Node.js 无法原生跑 HTTP/3，目前没有稳定、开箱即用的调试方案。 Node.js 官方直到 v20.12+ 才实验性支持 QUIC（HTTP/3 底层协议），且需编译时启用 --experimental-quic，而 VSCode 的内置调试器、launch.json 和主流运行时（如 nodemon）均不识别或传递该 flag；更关键的是，Chrome/Firefox 在 localhost 上默认禁用 HTTP/3，除非服务端明确支持并返回 Alt-Svc 头——本地开发几乎不可能达成闭环联调。
Node.js 原生 HTTP/3 支持现状（v20.12+）
Node.js 从 v20.12 起通过 net.Socket 和 quic 模块提供底层 QUIC 支持，但：
- 必须手动启用：
node --experimental-quic index.js，launch.json中的runtimeArgs无法可靠注入该 flag（VSCode 调试器会忽略或报错） -
http3.createServer()不是标准 API，需直接操作quic.createQuicSocket()，无 Express/Koa 等框架适配 - 证书要求严格：必须用
ECDSA密钥 +P-256曲线，RSA 证书会被拒绝，且需同时提供key、cert、ca三文件 - 浏览器不认本地
https://localhost:8443的 HTTP/3：即使服务跑起来，DevTools Network 面板仍显示h2，因为缺少 ALPN 协商或Alt-Svc响应头
launch.json 里硬加 --experimental-quic 会失败
在 launch.json 的 runtimeArgs 中写 "--experimental-quic" 看似合理，但实际会触发：
- VSCode 报错：
Unknown option: --experimental-quic（调试器启动前校验失败） - 或静默降级为普通 HTTP/1.1 启动，控制台无提示，但
quic.createQuicSocket()抛ERR_FEATURE_UNAVAILABLE_ON_PLATFORM - 根本原因：VSCode 使用的
vscode-js-debug依赖旧版 V8 inspector 协议，与 QUIC 的 event loop 扩展冲突
替代方案：用 curl + http3 命令行验证，而非 VSCode 调试
若目标只是验证 HTTP/3 行为（比如测试请求头、响应体、连接复用），绕过 VSCode 调试更可行：
- 终端手动运行：
node --experimental-quic --no-warnings ./server.js（关闭警告避免干扰） - 用
curl -v --http3 https://localhost:8443/测试（需安装支持 HTTP/3 的 curl，如curl 8.9+编译时带nghttp3+quiche） - 服务端日志加
console.log('HTTP/3 connection from', socket.remoteAddress)，确认 QUIC 连接建立 - VSCode 仅用于编辑和断点调试业务逻辑（如路由处理），HTTP/3 协议层问题靠命令行复现
真正卡住的不是代码写法，而是工具链断层：Node.js 的 QUIC 实现尚处实验期，VSCode 调试器没跟进，浏览器对 localhost 的 HTTP/3 限制又极死。现在硬要在 VSCode 里单步调试 HTTP/3 握手过程，基本等于徒手修航天飞机——理论上可能，实际上没人这么做。
