全局安装@nestjs/cli后执行nest命令提示未被识别的问题咨询

根本原因 #

npm全局安装包的可执行文件路径未被添加到系统环境变量Path中，导致系统无法找到nest的执行入口。

步骤1：获取npm全局安装路径 #

执行以下命令查询npm全局包的安装根路径：
npm config get prefix
执行后会返回对应路径，Windows系统默认路径通常为C:\Users\你的用户名\AppData\Roaming\npm，Mac/Linux系统默认路径通常为/usr/local或~/.npm-global。

步骤2：将路径添加到系统环境变量 #

• Windows系统操作：
  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在用户变量或系统变量列表中找到Path项，点击「编辑」
  3. 新增一条记录，填入步骤1查询到的完整npm全局路径，路径末尾需补充反斜杠，例如C:\Users\test\AppData\Roaming\npm\
  4. 依次点击所有弹窗的「确定」按钮保存配置
• Mac/Linux系统操作：
  1. 打开终端，编辑当前使用的shell配置文件，zsh用户编辑~/.zshrc，bash用户编辑~/.bashrc或~/.bash_profile
  2. 在文件末尾新增一行：export PATH="步骤1查询到的npm全局路径/bin:$PATH"，例如路径为~/.npm-global时，填写export PATH="~/.npm-global/bin:$PATH"
  3. 保存文件后执行source ~/.zshrc（对应你编辑的配置文件名）使配置立即生效

步骤3：验证配置效果 #

关闭所有已打开的终端/命令提示符/PowerShell窗口，重新打开新的命令窗口，执行nest --version，如果正常输出版本号即代表配置成功。

可选：npx执行命令失败修复 #

如果在项目目录下使用npx前缀执行nest命令报错，先在项目根目录执行以下命令将nest cli安装到项目开发依赖：
npm i @nestjs/cli --save-dev
安装完成后即可使用npx nest g module 模块名执行对应操作，也可以在package.json的scripts字段中添加"nest": "nest"，后续使用npm run nest -- g module 模块名执行命令。

极端情况修复 #

如果完成上述配置后仍然无法识别nest命令，先执行npm uninstall -g @nestjs/cli卸载全局安装的cli，再重新执行npm i -g @nestjs/cli安装即可。

内容的提问来源于stack exchange，提问作者Gabriel Baldez