项目创建与结构

这一课你将能做到

1. 用 Nest CLI 创建刷题平台项目 quiz-api，并通过 npm run start:dev 看到第一个响应
2. 指认 main.ts、AppModule、AppController、AppService 各自管什么
3. 修改返回内容与监听端口，验证热重载；看懂 package.json 里的脚本分工

为什么要学

Nest 官方推荐用 CLI 生成骨架，而不是从零手搭 tsconfig.json、Jest、目录约定。

人话：CLI 帮你铺好「能跑、能测、能编译」的地板，后面的课只往上加业务模块。不了解结构会出现三类典型问题：改错入口文件、不知道 Service 该登记在哪、生产环境直接用 ts-node 硬跑源码。花十分钟认清骨架，后面省几小时。

先建立图像

nest new quiz-api
        │
        ▼
src/
  main.ts              ← 启动入口：创建应用、监听端口
  app.module.ts        ← 根模块：imports / controllers / providers
  app.controller.ts    ← 示例 HTTP 入口
  app.service.ts       ← 示例业务类
test/                  ← e2e 测试目录
nest-cli.json          ← CLI 编译与资源规则
tsconfig.json          ← TypeScript 配置（含装饰器开关）
package.json

与 Spring Boot 的直觉对照：

NestJS	Spring Boot
main.ts 的 bootstrap()	public static void main
AppModule	@SpringBootApplication 配置起点
npm run start:dev	mvn spring-boot:run
dist/main.js	打包后的可执行 jar
nest generate	Spring Initializr / IDE 代码生成

跟着做

步骤 1：安装 CLI 并创建项目

在终端执行（Node.js 18+）：

npm install -g @nestjs/cli
nest new quiz-api

包管理器提示时选择 npm；新版本 CLI 默认开启 strict TypeScript，直接保留。然后：

cd quiz-api
npm run start:dev

浏览器打开 http://localhost:3000，应看到 Hello World!；终端同时打印 Nest 的启动日志和路由映射表 RouterExplorer。

步骤 2：读懂 main.ts 启动链

打开 main.ts，CLI 生成的内容大致是：

import { NestFactory } from "@nestjs/core";
import { AppModule } from "./app.module";

async function bootstrap() {
  // 人话：用根模块创建一个 Nest 应用实例
  const app = await NestFactory.create(AppModule);
  // 人话：监听端口，优先使用环境变量 PORT
  await app.listen(process.env.PORT ?? 3000);
}
bootstrap();