夜猫子的知识栈 夜猫子的知识栈
首页
  • 前端文章

    • JavaScript
  • 学习笔记

    • 《JavaScript教程》
    • 《Web Api》
    • 《ES6教程》
    • 《Vue》
    • 《React》
    • 《TypeScript》
    • 《Git》
    • 《Uniapp》
    • 小程序笔记
    • 《Electron》
    • JS设计模式总结
  • 《前端架构》

    • 《微前端》
    • 《权限控制》
    • monorepo
  • 全栈项目

    • 任务管理日历
    • 无代码平台
    • 图书管理系统
  • HTML
  • CSS
  • Nodejs
  • Midway
  • Nest
  • MySql
  • 其他
  • 技术文档
  • GitHub技巧
  • 博客搭建
  • Ajax
  • Vite
  • Vitest
  • Nuxt
  • UI库文章
  • Docker
  • 学习
  • 面试
  • 心情杂货
  • 实用技巧
  • 友情链接
收藏
  • 分类
  • 标签
  • 归档
GitHub (opens new window)

夜猫子

前端练习生
首页
  • 前端文章

    • JavaScript
  • 学习笔记

    • 《JavaScript教程》
    • 《Web Api》
    • 《ES6教程》
    • 《Vue》
    • 《React》
    • 《TypeScript》
    • 《Git》
    • 《Uniapp》
    • 小程序笔记
    • 《Electron》
    • JS设计模式总结
  • 《前端架构》

    • 《微前端》
    • 《权限控制》
    • monorepo
  • 全栈项目

    • 任务管理日历
    • 无代码平台
    • 图书管理系统
  • HTML
  • CSS
  • Nodejs
  • Midway
  • Nest
  • MySql
  • 其他
  • 技术文档
  • GitHub技巧
  • 博客搭建
  • Ajax
  • Vite
  • Vitest
  • Nuxt
  • UI库文章
  • Docker
  • 学习
  • 面试
  • 心情杂货
  • 实用技巧
  • 友情链接
收藏
  • 分类
  • 标签
  • 归档
GitHub (opens new window)
  • Node基础

  • 《MySQL》学习笔记

  • Midway

  • Nest

    • 开篇词
    • 学习理由
    • nest概念扫盲
    • 快速掌握 nestcli
      • nest new
      • nest generate'
      • nest build
      • nest-cli.json
      • nest start
      • nest info
      • 总结
    • 5种http数据传输方式
    • IoC 解决了什么痛点问题?
    • 如何调试 Nest 项目
    • Provider注入对象
    • 全局模块和生命周期
    • AOP 架构有什么好处?
    • 一网打尽 Nest 全部装饰器
    • Nest如何自定义装饰器
    • Metadata和Reflector
    • ExecutionContext切换上下文
    • Module和Provider的循环依赖处理
    • 如何创建动态模块
    • Nest和Express,fastify
    • Nest的Middleware
    • RxJS和Interceptor
    • 内置Pipe和自定义Pipe
    • ValidationPipe验证post请求参数
    • 如何自定义 Exception Filter
    • 图解串一串 Nest 核心概念
    • 接口如何实现多版本共存
    • Express如何使用multer实现文件上传
    • Nest使用multer实现文件上传
    • 图书管理系统
    • 大文件分片上传
    • 最完美的 OSS 上传方案
    • Nest里如何打印日志
    • 为什么Node里要用Winston打印日志
    • Nest 集成日志框架 Winston
    • 通过Desktop学Docker也太简单了
    • 你的第一个 Dockerfile
  • 其他

  • 服务端
  • Nest
神说要有光
2025-01-10
目录

快速掌握 nestcli

项目开发离不开工程化的部分,比如创建项目、编译构建、开发时 watch 文件变动自动构建等。

Nest 项目自然也是这样,所以它在 @nestjs/cli 这个包里提供了 nest 命令。

可以直接 npx 执行,npm 会把它下载下来然后执行:

npx @nestjs/cli new 项目名
1

也可以安装到全局,然后执行,更推荐这种:

npm install -g @nestjs/cli

nest new 项目名
1
2
3

不过后者要时不时升级下版本,不然可能用它创建的项目版本不是最新的:

npm update -g @nestjs/cli
1

那 nest 都提供了啥命令呢?

nest -h 看看:

有创建新项目的 nest new,有生成某些代码的 nest generate,还有编译构建的 nest build,开发模式的 nest start 等。

分别看一下:

# nest new

nest new 我们用过,就是创建一个新的 nest 项目的。

它有这么几个选项:

--skip-git 和 --skip-install 很容易理解,就是跳过 git 的初始化,跳过 npm install。

--package-manager 是指定包管理器的,之前创建项目的时候会让我们选择:

指定之后,就跳过包管理器选择这步了:

--language 可以指定 typescript 和 javascript,一般我们都选择 ts,用默认的就好。

--strict 是指定 ts 的编译选项是否开启严格模式的,也就是这么 5 个选项:

默认是 false,也可以指定为 true:

这个之后需要的话再改就行。

# nest generate'

nest 命令除了可以生成整个项目外,还可以生成一些别的代码,比如 controller、service、module 等。

比如生成 module:

nest generate module aaa
1

它会生成 module 的代码:

还会自动在 AppModule 里引入:

当然你也可以生成 controller、service 等代码:

nest generate controller aaa
1

同样,它也会更新到 module 的依赖里去。

生成 service 也是一样:

当然,如果是要完整生成一个模块的代码,不需要一个个生成,可以用

nest generate resource xxx
1

它会让你选择是哪种代码,因为 nest 支持 http、websocket、graphql、tcp 等,这里我们选择 http 的 REST 风格 api:

然后会让你选择是否生成 CRUD 代码:

选择是。

然后就会生成整个模块的 CRUD + REST api 的代码:

当然,它同样会自动在 AppModule 引入:

这就是 nest generate,可以快速生成各种代码:

这些代码模版的集合是在 @nestjs/schematics 这个包里定义的。

nest new 创建项目的时候有个 --collection 选项,就是配置这个的。

不过一般我们不需要配置。

你可以在 @nestjs/schematics (opens new window) 里看到这些代码模版的定义:

它的实现原理很简单,就是模版引擎填充变量,打印成代码:

nest generate 也有不少选项:

--flat 和 --no-flat 是指定是否生成对应目录的:

--spec 和 --no-spec 是指定是否生成测试文件:

--skip-import 是指定不在 AppModule 里引入:

也就是不生成这部分代码:

至于 --project,这是指定生成代码在哪个子项目的,等之后用到 monorepo 项目的时候再说。

这就是 nest cli 提供的快速生成各种代码的能力,是不是还挺方便的?

# nest build

然后就是 nest build 了,它是用来构建项目的:

执行 nest build,会在 dist 目录下生成编译后的代码。

同样,它也有一些选项:

--wepback 和 --tsc 是指定用什么编译,默认是 tsc 编译,也可以切换成 webpack。

这是 tsc 的编译产物:

这是 webpack 的编译产物:

tsc 不做打包、webpack 会做打包,两种方式都可以。

node 模块本来就不需要打包,但是打包成单模块能提升加载的性能。

--watch 是监听文件变动,自动 build 的。

但是 --watch 默认只是监听 ts、js 文件,加上 --watchAssets 会连别的文件一同监听变化,并输出到 dist 目录,比如 md、yml 等文件。

--path 是指定 tsc 配置文件的路径的。

那 --config 是指定什么配置文件呢?

是 nest cli 的配置文件。

# nest-cli.json

刚刚我们说的那些选项都可以在 nest-cli.json 里配置:

比如 compilerOptions 里设置 webpack 为 true 就相当于 nest build --webpack,一样的效果:

webpack 设置为 false 就是用 tsc 了。

deleteOutDir 设置为 true,每次 build 都会都清空 dist 目录。

而 assets 是指定 nest build 的时候,把那些非 js、ts 文件也复制到 dist 目录下。

可以通过 include、exclude 来精确匹配,并且可以单独指定是否 watchAssets。

不过只支持 src 下文件的复制,如果是非 src 下的,可以自己写脚本复制:

然后是 generateOptions,这些就和我们 nest generate 时的 --no-spec、--no-flat 一样的效果。

比如我把 flat 设置为 false、spec 设置为 false,那再 generate 代码时就是这样的:

生成了一层目录,并且没有生成测试文件。

sourceRoot 是指定源码目录。

entryFile 是指定入口文件的名字,默认是 main。

而 $schema 是指定 nest-cli.json 的 schema,也就是可以有哪些属性的:

https://json.schemastore.org/nest-cli (opens new window)

这是一种 json schema 的规范,还是挺容易看懂的:

如果想全面了解 nest-cli.json 都有啥属性,可以看看这个 schema 定义。

# nest start

最后,再来看下 nest start 命令:

可以看到每次重新 build 了,并且用 node 把 main.js 跑了起来。

它有这些选项:

--watch 是最常用的选项了,也就是改动文件之后自动重新 build:

--debug 是启动调试的 websocket 服务,用来 debug。

--exec 可以指定用什么来跑,默认是用 node 跑,你也可以切换别的 runtime。

其余选项和 nest build 一样,就不复述了。

# nest info

最后还有个 nest info 命令,这个就是查看项目信息的,包括系统信息、 node、npm 和依赖版本:

# 总结

nest 在 @nestjs/cli 包里提供了 nest 命令,它可以用来做很多事情:

  • 生成项目结构和各种代码
  • 编译代码
  • 监听文件变动自动编译
  • 打印项目依赖信息

也就是这些子命令:

  • nest new 快速创建项目
  • nest generate 快速生成各种代码
  • nest build 使用 tsc 或者 webpack 构建代码
  • nest start 启动开发服务,支持 watch 和调试
  • nest info 打印 node、npm、nest 包的依赖版本

并且,很多选项都可以在 nest-cli.json 里配置,比如 generateOptions、compilerOptions 等。

学会用 nest cli,是学好 nest 很重要的一步。

编辑 (opens new window)
上次更新: 2025/5/14 16:47:16
nest概念扫盲
5种http数据传输方式

← nest概念扫盲 5种http数据传输方式→

最近更新
01
IoC 解决了什么痛点问题?
03-10
02
如何调试 Nest 项目
03-10
03
Provider注入对象
03-10
更多文章>
Copyright © 2019-2025 Study | MIT License
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式