VSCode本身不支持HTTP2，真正起作用的是Node.js版本（需≥v12.0）和代码是否显式调用require('http2')；低于该版本会报“Cannot find module 'http2'”，且调试时须匹配模块系统（ESM需用pwa-node）。
VSCode 本身不决定是否支持 HTTP2，它只是编辑器；真正起作用的是你运行的 Node.js 版本和代码写法。Node.js 从 v8.4.0 起原生支持 HTTP2，但默认不启用 —— 必须显式调用 http2 模块，且不能靠 npm start 自动切换。
node -v 输出低于 12.0 就别试 HTTP2
HTTP2 在早期 Node 版本中是实验性功能（需加 --experimental-http2），但自 Node.js v12.0 起已稳定可用。低于该版本：require('http2') 会直接报错 Cannot find module 'http2'。
- 运行
node -v验证：必须 ≥v12.0.0，推荐 LTS 版本（如v20.15.0或v18.20.0） - macOS 用户若用 Homebrew 安装，执行
brew upgrade node；Windows 用户重装官网 LTS 包（务必勾选 “Add to PATH”） - VSCode 内置终端里
node -v和系统终端输出不一致？说明 VSCode 没继承正确 PATH —— 关闭所有 VSCode 进程，从终端执行code --no-sandbox .启动
require('http2') 报错“Module not found”
这不是插件或配置问题，而是 Node 运行时根本没加载 http2 模块。它不是 polyfill，也不依赖 npm 包，是 Node 内置模块，但需要满足两个前提：
- Node 版本达标（见上一条）
- 代码里不能写成
const http2 = require('https').createServer()—— 这是常见误解。https模块不提供 HTTP2；必须直引：const http2 = require('http2') - 启动脚本不能依赖
nodemon或ts-node默认行为：它们默认以 CommonJS 模式运行，而 HTTP2 的createSecureServer需要传入key和cert，且证书路径必须是绝对路径（相对路径在 nodemon 重启后易失效）
launch.json 调试 HTTP2 服务时断点不命中
VSCode 调试器对 http2 没特殊支持，断点失效通常卡在三个地方：
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
-
"type": "node"调试器默认按 CommonJS 解析，但如果你项目声明了"type": "module"（ESM），必须改用"type": "pwa-node"，否则import语句直接崩溃 -
"program"字段不能写"${file}"—— HTTP2 服务通常需监听端口、加载证书，单文件调试无法覆盖完整流程；应指定入口文件，例如："program": "${workspaceFolder}/server.js" - 证书路径用了相对路径（如
./certs/key.pem）：调试时工作目录可能是${workspaceFolder}，但http2.createSecureServer()内部读取时路径解析可能出错；统一用path.resolve(__dirname, 'certs', 'key.pem')
用 code-runner 运行 HTTP2 脚本失败
code-runner 默认以 CommonJS 方式执行，且不支持传参（比如 --inspect）或设置环境变量，对 HTTP2 这类需证书/端口/安全上下文的服务极不友好。
- 禁用
code-runner运行 HTTP2 服务：它只适合跑单文件 demo，不适用于真实服务启动 - 改用终端手动运行：
node --trace-warnings server.js（加--trace-warnings可捕获证书加载失败等静默错误） - 如果一定要一键运行，用 VSCode 的
tasks.json定义 task：command设为node，args显式传入["--trace-warnings", "${file}"]，并设"group": "build"
HTTP2 的坑不在 VSCode 配置，而在 Node 运行时约束：证书必须有效（localhost 可用 mkcert 生成）、模块引用必须精确、调试器类型必须匹配模块系统。任何一环松动，都会表现为“没反应”或“报错但不提示原因”。
