website

NestJS Docs

所属分类:开发者在线工具箱

NestJS 框架的官方文档,含入门步骤、模块与数据库等专题,以及独立应用指南。

NestJS Docs 是 Node.js 服务端框架 NestJS 的官方文档站。左侧目录按入门、基础、应用、数据、安全、HTTP、GraphQL、WebSocket 和微服务等类别组织。入门页说明运行环境和 Nest CLI 的生成步骤,独立应用页介绍如何在没有网络监听的情况下复用模块中的服务,例如在定时任务中调用它们。

NestJS Docs:Node.js 服务端框架 NestJS 的官方文档,从第一个项目到独立应用

发布于 2026年10月18日更新于 2026年10月29日

框架定位

首页 Introduction 说明,Nest 是用于构建高效、可扩展的 Node.js 服务端应用的框架。它基于 TypeScript 构建并完整支持 TypeScript,也允许使用纯 JavaScript 编写。

底层 HTTP 服务默认使用 Express,也可以配置为 Fastify。页面写明,Nest 在 Express 与 Fastify 之上提供一层抽象,同时仍然保留直接使用它们 API 的能力,因此可以用到底层平台上的第三方模块。Philosophy 一节提到,Nest 的架构受 Angular 启发,目标是让团队写出可测试、松耦合、易维护的应用。

NestJS 官方文档 Introduction 页面截图,左侧为深色目录,正文标题为 Introduction,下方是 Philosophy 与 Installation 小节,页面顶部有 Copy markdown 按钮

入门:环境要求与第一个项目

First steps 页面说明,运行 Nest 应用需要 Node.js v20.19 或更高版本,或 22.x 系列的 v22.12 以上版本。Nest CLI 的生成命令(nest new、nest generate)则需要 v22.22.3 以上、v24.15 以上或 v26 以上。页面推荐使用最新的活跃 LTS 版本,两项要求都能满足。

安装 CLI 并生成项目的命令是 npm i -g @nestjs/cli 和 nest new project-name。CLI 会询问使用哪种模块系统:默认是 ESM,测试框架为 Vitest;也可以选择 CommonJS,测试框架为 Jest。它还会询问是否接入官方可观测性平台 NestJS Observe。页面注明,新项目默认启用 TypeScript 严格模式。

首页 Installation 一节还提供另一种方式:用 Git 克隆起始项目,结果与 CLI 生成的相同。

独立应用:没有网络监听的 Nest 应用

Standalone applications 页面说明,Nest 可以创建 Web 应用、微服务,也可以创建不带网络监听的独立应用。独立应用是 Nest IoC 容器的包装,通过它可以取得已导入模块中任意已实例化类的引用。

页面给出的例子是:TasksService 位于 TasksModule 中,而 TasksModule 被 AppModule 导入,定时任务(CRON)可以调用它的方法。页面还提到,可以在独立应用之上构建 CLI。入口代码是 NestFactory.createApplicationContext(AppModule)。

NestJS 独立应用页面截图,正文标题为 Standalone applications,中部是 Getting started 小节的 JavaScript 示例代码,示例中调用 NestFactory.createApplicationContext(AppModule),下方为 Retrieving providers from static modules 小节