#第一步

在这一系列文章中，你将学习 Nest 的核心基础。为了熟悉 Nest 应用程序的基本构建块，我们将构建一个涵盖了许多入门级功能的 CRUD 基础应用程序。

#语言

我们热爱 TypeScript，但最重要的是——我们热爱 Node.js。因此，Nest 同时兼容 TypeScript 和纯 JavaScript。Nest 利用了最新的语言特性，所以要在原生 JavaScript 中使用它，我们需要一个 Babel 编译器。

我们提供的示例将主要使用 TypeScript，但你可以随时将代码片段切换为原生 JavaScript 语法（只需点击每个代码片段右上角的语言切换按钮即可）。

#先决条件

请确保你的操作系统上安装了 Node.js (版本 >= 20)。

#Node.js 安装指南 (国内用户优化)

为了帮助中国用户更好地安装 Node.js，这里提供详细的安装指南：

安装方式：

1. 访问官网下载：前往 Node.js 官网 下载最新的 LTS（长期支持）版本。
2. 使用包管理器：
   • Windows: 使用 Chocolatey 或 Scoop
   • macOS: 使用 Homebrew 或 MacPorts
   • Linux: 使用系统包管理器（如 apt、yum、dnf 等）
3. 使用版本管理器：
   • nvm（Linux/macOS）
   • nvm-windows（Windows）
   • fnm（跨平台）

验证安装：

安装完成后，可以通过以下命令验证 Node.js 和 npm 是否正确安装：

$ node --version
$ npm --version

网络问题解决方案：

如果遇到网络问题，可以尝试使用淘宝镜像：

# 设置淘宝镜像
$ npm config set registry https://registry.npmmirror.com

# 或者使用 cnpm
$ npm install -g cnpm --registry=https://registry.npmmirror.com

#设置

使用 Nest CLI 搭建新项目非常简单。安装 npm 后，你可以在操作系统终端中使用以下命令创建新的 Nest 项目：

$ npm i -g @nestjs/cli
$ nest new project-name

project-name 目录将被创建，node 模块和一些其他样板文件将被安装，src/ 目录将被创建并填充几个核心文件。

以下是这些核心文件的简要概述：

main.ts 包含一个异步函数，它将引导我们的应用程序：

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

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(process.env.PORT ?? 3000);
}
bootstrap();

要创建 Nest 应用程序实例，我们使用核心的 NestFactory 类。NestFactory 暴露了几个静态方法，允许创建应用程序实例。create() 方法返回一个应用程序对象，该对象实现了 INestApplication 接口。该对象提供了一组方法，这些方法将在后续章节中描述。在上面的 main.ts 示例中，我们只是启动了 HTTP 监听器，这让应用程序可以等待入站的 HTTP 请求。

请注意，使用 Nest CLI 搭建的项目会创建一个初始项目结构，鼓励开发者遵循将每个模块保存在其自己的专用目录中的约定。

#平台

Nest 旨在成为一个平台无关的框架。平台独立性使得创建可重用的逻辑部分成为可能，开发者可以在几种不同类型的应用程序中利用这些部分。从技术上讲，一旦创建了适配器，Nest 就能够与任何 Node HTTP 框架一起工作。开箱即用支持两个 HTTP 平台：express 和 fastify。你可以选择最适合你需求的平台。

无论使用哪个平台，它都会暴露自己的应用程序接口。这些分别被看作 NestExpressApplication 和 NestFastifyApplication。

当您将类型传递给 NestFactory.create() 方法时，如下面的示例所示，app 对象将具有专门用于该特定平台的方法。但是请注意，除非您实际想要访问底层平台 API，否则您不需要指定类型。

const app = await NestFactory.create<NestExpressApplication>(AppModule);

#运行应用程序

安装过程完成后，您可以在操作系统命令提示符下运行以下命令来启动监听入站 HTTP 请求的应用程序：

$ npm run start

提示 为了加快开发过程（构建速度快 20 倍），您可以通过在 start 脚本中传递 -b swc 标志来使用 SWC 构建器，如下所示 npm run start -- -b swc。

此命令启动应用程序，HTTP 服务器监听 src/main.ts 文件中定义的端口。应用程序运行后，打开浏览器并导航到 http://localhost:3000/。您应该看到 Hello World! 消息。

要监视文件中的更改，您可以运行以下命令来启动应用程序：

$ npm run start:dev

此命令将监视您的文件，自动重新编译并重新加载服务器。

#代码检查与格式化

CLI 致力于为大规模开发提供可靠的工作流脚手架。因此，生成的 Nest 项目预装了代码检查工具和格式化工具（分别是 eslint 和 prettier）。

提示 不确定格式化工具与代码检查工具的区别？请查看此处了解。

为了确保最大的稳定性和可扩展性，我们使用基础的 eslint 和 prettier cli 包。这种设置允许与官方扩展进行良好的 IDE 集成。

对于不依赖 IDE 的无头环境（持续集成、Git hooks 等），Nest 项目附带了可立即使用的 npm 脚本：

# 使用 eslint 进行代码检查和自动修复
$ npm run lint

# 使用 prettier 进行代码格式化
$ npm run format