使用Yarn创建NestJS新项目失败：执行yarn install --silent出错

环境信息 #

• Windows：10.0.19044.3086
• Node：18.17.1
• npm：9.6.7
• Yarn：1.22.19
• Nest CLI：10.1.16

排查与解决步骤 #

1. 升级Yarn版本 #

Nest CLI 10.x与Yarn 1.22.19可能存在兼容性问题，建议升级到Yarn Classic最新稳定版：

yarn set version classic

或切换至Yarn Berry（2.x+）：

yarn set version berry

2. 手动创建项目绕开CLI自动安装流程 #

如果Nest CLI的自动初始化逻辑出错，手动完成项目搭建：

1. 创建并进入项目目录：

   mkdir task_management && cd task_management
   

2. 初始化package.json：

   yarn init -y
   

3. 安装核心依赖：

   yarn add @nestjs/common @nestjs/core @nestjs/platform-express reflect-metadata rxjs
   

4. 安装开发依赖：

   yarn add -D @nestjs/cli @nestjs/schematics @types/node typescript ts-loader ts-node tsconfig-paths jest @nestjs/testing @types/jest
   

5. 从Nest官方模板复制tsconfig.json、nest-cli.json等配置文件到项目中。

3. 切换Yarn镜像源 #

网络问题可能导致依赖拉取失败，切换到国内镜像源：

# 查看当前源
yarn config get registry
# 切换至淘宝镜像
yarn config set registry https://registry.npmmirror.com

4. 彻底清理缓存 #

清理Yarn缓存并移除残留文件：

# 清理Yarn缓存
yarn cache clean
# Windows环境删除残留文件
rmdir /s/q node_modules && del yarn.lock
# 重新执行安装
yarn install

5. 以管理员权限运行终端 #

Windows下权限不足可能导致安装失败，右键终端选择以管理员身份运行，再执行nest new task_management。

6. 重装Nest CLI #

重新安装匹配版本的Nest CLI，避免全局包损坏：

npm uninstall -g @nestjs/cli
npm install -g @nestjs/cli@10.1.16

内容的提问来源于stack exchange，提问作者Khaled Boussoffara