快速开始

准备 Node.js 与 npm。以下两种方式都可以启动服务；CLI 会生成项目结构，单文件方式便于查看最小代码。

创建项目

TypeScript

npm create nova-http@latest my-app -- --template minimal --lang ts
cd my-app
npm install
npm run dev

JavaScript

npm create nova-http@latest my-app -- --template minimal --lang js
cd my-app
npm install
npm run dev

默认生成 minimal TypeScript 模板。需要路由和中间件分目录的起点时，使用 --template api。完整选项见 CLI 参考。

运行单文件服务

在空目录中执行 npm init -y 和 npm install nova-http，创建 app.mjs：

import { createApp } from "nova-http";

export function buildApp() {
  const app = createApp();
  app.get("/hello/:name", (req, res) => {
    res.json({ hello: req.params.name });
  });
  return app;
}

// 供文档检查导入；直接运行文件时启动服务。
if (!process.env.NOVA_DOCS_CHECK) {
  await buildApp().listen(3000, "127.0.0.1");
  console.log("http://127.0.0.1:3000/hello/Nova");
}

node app.mjs

.mjs 使用 ESM，允许顶层 await。TypeScript 模板已有自身的编译和启动配置，无需将此文件改名后直接替换模板。

验证响应

curl http://127.0.0.1:3000/hello/Nova

预期响应：

{ "hello": "Nova" }

Windows PowerShell 如果将 curl 解析为别名，可以使用 curl.exe。端口被占用时修改 app.listen() 的端口；停止本地服务使用 Ctrl+C。

接下来阅读路由与子应用，或从项目组织开始拆分业务模块。