VSCode 开发 Hapi.js 应用需先确保 Node.js 和 npm 在 PATH 中，再通过 npm 初始化项目、安装 hapi/inert/vision 及 nodemon，配置 package.json 的 "dev" 脚本，并手动创建 launch.json 实现 F5 调试；注意 Hapi v20+ 语法变更与端口冲突问题。
VSCode 本身不内置 Hapi.js 支持，但只要 Node.js 环境就绪、项目结构清晰、调试配置得当，就能高效开发 Hapi.js 应用——关键不是装什么“Hapi 插件”，而是让 server.js 能被 VSCode 正确识别、启动和断点调试。
确认 Node.js 和 npm 已就绪且在 PATH 中
这是所有后续操作的前提。VSCode 的终端（Ctrl + `）必须能直接运行 node -v 和 npm -v。若报 command not found，说明安装时没勾选 “Add to PATH” 或环境变量未生效——重启 VSCode 甚至系统后重试。Windows 用户尤其注意：MSI 安装包默认勾选该选项，但若用 ZIP 手动解压，则需手动配置 PATH。
用 npm 初始化项目并安装 Hapi.js 及必要插件
在 VSCode 终端中执行以下命令，不要跳过 inert 和 vision（它们是静态文件与模板渲染的基础）：
-
npm init -y（快速生成package.json） -
npm install hapi inert vision（Hapi v19+ 推荐用此组合；若用 v20+，vision已弃用，改用@hapi/vision） -
npm install --save-dev nodemon（用于热重载，避免每次改代码都手动Ctrl+C再node server.js）
然后在 package.json 的 scripts 中加入："dev": "nodemon server.js"。之后只需运行 npm run dev 即可监听变更。
创建 server.js 并配置 VSCode 调试（launch.json）
VSCode 默认无法直接 F5 启动 server.js，必须手动配置 .vscode/launch.json。在项目根目录下建好 server.js（比如最简版）：
const Hapi = require('hapi');
const server = Hapi.server({ port: 3000, host: 'localhost' });
server.route({
method: 'GET',
path: '/',
handler: (request, h) => 'Hello from Hapi!'
});
const start = async () => {
await server.start();
console.log(`Server running at ${server.info.uri}`);
};
start();
接着按 Ctrl+Shift+P → 输入 “Debug: Open launch.json” → 选择 “Node.js” 环境 → 替换生成的内容为：
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Launch Hapi Server",
"skipFiles": ["<node_internals>/**"],
"program": "${workspaceFolder}/server.js",
"console": "integratedTerminal",
"env": { "NODE_ENV": "development" }
}
]
}
此时按 F5 就能启动服务，并在 server.route 或 handler 内设断点调试。注意：nodemon 和 VSCode 调试不能共存——调试时用 F5，开发时用 npm run dev，别混用。
常见错误：404 Not Found 或端口被占
Hapi 启动后访问 http://localhost:3000 返回 404，通常不是代码问题，而是路由没注册或路径不匹配。检查：
- 是否漏掉
await server.start()（v19+ 必须异步启动） - 路由
path是否以/开头（如写成'home'会匹配/home，但'/home'才是标准写法） - 端口是否被占用：启动时报
Error: listen EADDRINUSE时，改port值，或用lsof -i :3000（macOS/Linux）或netstat -ano | findstr :3000（Windows）查 PID 并kill掉
真正容易被忽略的是：Hapi v20+ 移除了 server.connection()，改用构造函数参数传入 port 和 host；而很多老教程、Stack Overflow 示例还在用 v17 语法，直接复制会导致启动失败且无明确报错——务必核对所用 Hapi 版本的官方文档。
