NestJS执行nest g module book命令报@nestjs/schematics执行失败

问题表现 #

执行模块生成命令nest g module book时触发执行失败，报错输出如下：

Failed to execute command: node @nestjs/schematics:guard --name=book --no-dry-run --no-skipImport --language="ts" --sourceRoot="src" --spec
该异常本质是CLI的schematic调用错位：输入模块生成指令后，框架错误触发了守卫（guard）的生成逻辑，属于Nest CLI使用中的典型版本/配置类问题。

排查方向 #

按优先级从高到低排查以下问题点：

• 全局安装的@nestjs/cli版本与当前项目本地的NestJS核心依赖（@nestjs/core、@nestjs/schematics）大版本不匹配，这是该类报错的最高发诱因。
• 项目本地依赖安装不全、文件损坏，或npm缓存异常导致schematic执行文件缺失。
• 项目根目录nest-cli.json配置被篡改，比如schematic集合配置错误、sourceRoot路径与实际目录结构不符。
• 终端存在nest命令别名冲突，或全局安装了重名命令行工具，导致指令被错误解析。

解决步骤 #

1. 对齐CLI与项目依赖版本
   90%以上的同类schematic调用错位问题都是版本不匹配导致，优先操作这一步基本可以解决问题
   先执行nest --version查看全局CLI版本，再打开项目package.json查看本地@nestjs/core的版本号，如果两者大版本号不一致（比如全局是v9、项目依赖是v10），直接在项目本地安装匹配版本的CLI，通过npx调用本地版本执行生成命令即可规避全局版本冲突：

   # 以项目使用NestJS 10版本为例
   npm install -D @nestjs/cli@10
   # 调用本地CLI执行生成命令
   npx nest g module book
   

   如果需要使用全局CLI，卸载原有全局版本后安装对应大版本即可：

   npm uninstall -g @nestjs/cli
   npm install -g @nestjs/cli@10 # 替换成和你项目匹配的版本号
   

2. 修复损坏的依赖
   版本对齐后仍报错的话，清理旧依赖和锁文件后重装：

   # 删除依赖目录
   rm -rf node_modules
   # 按使用的包管理器删除对应锁文件，npm执行下一行，yarn/pnpm对应删yarn.lock/pnpm-lock.yaml
   rm package-lock.json
   # 重新安装依赖
   npm install
   

   重装前可以先执行npm cache clean --force清理全局缓存，避免缓存的损坏文件被重复使用。

3. 修正CLI配置
   打开项目根目录的nest-cli.json，确认配置符合默认结构，重点检查collection字段必须指向@nestjs/schematics，sourceRoot字段和你实际的源码目录（默认是src）一致，标准参考配置如下：

   {
     "$schema": "https://json.schemastore.org/nest-cli",
     "collection": "@nestjs/schematics",
     "sourceRoot": "src",
     "compilerOptions": {
       "deleteOutDir": true
     }
   }
   

4. 排查命令冲突
   执行which nest（macOS/Linux）或where nest（Windows）查看nest命令的实际指向路径，确认指向的是NestJS CLI的安装位置，如果指向其他自定义脚本/工具，调整别名配置或重命名冲突工具即可。

内容的提问来源于stack exchange，提问作者Dennis Githinji Wakahia