使用yarn PnP安装依赖后TypeScript编译无法找到模块如何解决？

你使用的是Yarn 3+版本，默认启用Plug'n'Play（PnP）依赖管理机制，不会生成node_modules文件夹。原生TypeScript编译器默认仅从node_modules路径查找依赖和类型定义，无法识别PnP的依赖映射规则，因此出现找不到模块、找不到Node.js全局变量类型的报错。

方案一（推荐，长期生效） #

1. 安装Yarn官方SDK适配工具

yarn add -D @yarnpkg/sdks

2. 生成TypeScript适配文件

yarn sdks typescript

该命令会自动在项目.yarn目录下生成适配PnP规则的TypeScript包装文件，同时自动更新编辑器相关配置，若使用VSCode等编辑器，按照提示启用推荐的PnP支持插件即可。
3. 补充tsconfig.json配置
在compilerOptions字段中新增两项配置：

"types": ["node"],
"moduleResolution": "NodeNext"

这两项配置用于让TypeScript明确识别Node.js内置类型，以及适配带node:前缀的内置模块导入规则。
4. 执行编译命令
使用yarn调用本地TypeScript编译器即可，不要直接调用全局tsc：

yarn tsc

Yarn会自动注入PnP路径规则，让TypeScript正常识别所有依赖。

方案二（临时编译用） #

如果仅需要临时执行编译，不想修改项目配置，可以使用pnpify工具包装编译命令：

1. 安装pnpify工具

yarn add -D @yarnpkg/pnpify

2. 执行编译

yarn pnpify tsc

配置完成后无需生成node_modules，可完全保留Yarn PnP的无node_modules运行模式，TypeScript可以正常适配该机制。

内容的提问来源于stack exchange，提问作者L.Wiseby