nest generate从入门到实战
一、nest generate 是什么？
nest generate（简称 nest g）是 NestJS CLI 提供的代码生成器，用于快速创建 Nest 应用中的各类模块、控制器、服务、过滤器、管道等结构，极大提升开发效率。
二、核心命令与用法
| 命令示例 | 说明 |
|---|---|
nest g module user | 生成模块（module）文件，自动注册到根模块中 |
nest g controller user --no-spec | 生成控制器（controller），--no-spec 跳过测试文件 |
nest g service user | 生成服务（service），自动注入到对应模块中 |
nest g resource user | 一键生成完整 REST API 模块：module + controller + service + CRUD |
nest g filter xxx | 生成异常过滤器 |
nest g pipe xxx | 生成验证/转换管道 |
nest g guard xxx | 生成权限守卫 |
nest g interceptor xxx | 生成拦截器 |
三、目录结构与自动注入机制
以如下命令为例：
nest g module modules/user
nest g controller modules/user --no-spec
nest g service modules/user --no-spec
生成结构：
src/
└── modules/└── user/├── user.controller.ts├── user.service.ts└── user.module.ts
自动注入机制：
生成的 UserModule 中会自动引入 UserController 和 UserService，并在 AppModule 中自动导入 UserModule，无需手动配置。
四、高级用法：nest g resource
这是 NestJS 提供的最强生成命令，支持：
- REST API
- GraphQL
- WebSocket
- Microservice
示例：
nest g resource products
交互式选择：
- Transport layer:
REST - Generate CRUD entry points:
Yes
结果：
自动生成完整的 RESTful CRUD 接口，包括 DTO、Entity、Controller、Service、Module，甚至带分页与验证。
五、底层原理：基于 Schematics 的模板引擎
NestJS CLI 的生成逻辑依赖于 @nestjs/schematics 包，它定义了各种模板（如 controller、service、module 等）的结构与生成规则。
- 模板路径：
@nestjs/schematics/src/**/files/ - 支持自定义模板（通过
--collection参数指定） - 可通过
.nestcli.json配置默认行为
六、常见问题与排查
| 问题描述 | 原因 | 解决方案 |
|---|---|---|
isNullOrUndefined is not a function | @nestjs/schematics 版本过低 | npm update @nestjs/schematics |
| 生成文件未自动导入 | 项目结构不符合 Nest 规范 | 使用标准目录结构（如 src/ 下） |
| 测试文件太多 | 不需要测试 | 加 --no-spec 参数 |
七、实战建议
| 场景 | 推荐命令 |
|---|---|
| 快速开发 REST API | nest g resource xxx |
| 微服务模块 | nest g module xxx，手动配置 transport |
| 权限模块 | nest g guard auth，结合守卫机制 |
| 统一异常处理 | nest g filter http-exception |
八、总结一句话
nest generate是 NestJS 的灵魂命令之一，它不仅是一个脚手架工具，更是 NestJS 模块化、解耦、IoC/DI 架构思想的落地体现。
如需进一步扩展，可自定义 schematics 模板，实现企业级代码生成规范。