Yarn 3.x Plug 'N Play模式失效，NestJS依赖导入失败求助

你的问题核心是Yarn 3.x的PNP模式未被TypeScript和编辑器正确识别——PNP不生成传统node_modules目录，依赖路径通过.pnp.cjs等文件管理，默认配置下TypeScript和编辑器无法解析这些路径。以下是具体解决步骤：

1. 配置TypeScript支持PNP解析 #

在项目根目录的tsconfig.json中，添加或修改以下配置：

{
  "compilerOptions": {
    "moduleResolution": "node",
    "plugins": [
      { "name": "@yarnpkg/esbuild-plugin-pnp" },
      { "name": "@yarnpkg/plugin-pnp" }
    ]
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", ".yarn/*"]
}

同时安装必要的PNP依赖插件：

yarn add -D @yarnpkg/plugin-pnp @yarnpkg/esbuild-plugin-pnp

2. 让编辑器（以VS Code为例）适配PNP环境 #

• 安装VS Code的Yarn PNP官方扩展
• 在项目根目录创建.vscode/settings.json，写入以下配置：

{
  "typescript.tsdk": ".yarn/sdks/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true,
  "nodePath": ".yarn/pnp.cjs"
}

执行命令生成Yarn适配SDK，之后重启VS Code：

yarn dlx @yarnpkg/sdks vscode

3. 检查并简化Yarn配置 #

确保.yarnrc.yml的PNP相关配置简洁无冲突，基础配置如下：

nodeLinker: pnp
pnpMode: loose

清空原有冲突配置后，执行yarn install重新安装依赖。

4. 规范项目操作流程 #

完全使用Yarn命令管理项目，避免混用npm：

• 安装依赖：yarn install
• 启动项目：yarn start:dev
  若仍有报错，尝试清除缓存后强制重装：

yarn cache clean
yarn install --force

额外优化建议 #

全局NestJS CLI若用npm安装，可能存在版本适配问题，建议改用Yarn重新安装：

yarn global add @nestjs/cli

之后用nest new创建项目时选择Yarn，生成的配置会更适配Yarn 3.x。

内容的提问来源于stack exchange，提问作者Nathan Tew