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 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 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 没特殊支持，断点失效通常卡在三个地方：
-
"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 生成）、模块引用必须精确、调试器类型必须匹配模块系统。任何一环松动，都会表现为“没反应”或“报错但不提示原因”。
