Yarn v3.0.2未生成node_modules文件夹的原因及是否需额外执行npm install的技术咨询
2026-4-30
嘿，这个问题问得很典型！其实这是Yarn 3（也就是大家常说的Yarn Berry）默认启用的Plug'n'Play (PnP) 机制搞的事儿，咱们把疑问一个个解开：
为什么Yarn 3.0.2不会生成node_modules文件夹？
Yarn 3彻底放弃了传统的node_modules依赖管理模式，默认用PnP来替代。它会生成一个.pnp.cjs（或相关PnP文件），这个文件相当于一个"依赖地图"，直接记录每个依赖的精确存储位置，让Node.js通过它直接找到依赖，不用再把所有依赖都复制到项目的node_modules目录里。
这种模式的好处很实在：
- 省磁盘空间，避免不同项目重复安装相同版本的依赖
- 安装速度更快，不用处理大量文件复制操作
- 从根源上减少依赖版本冲突的概率
要不要额外运行
npm install？完全不用！ 千万别混用Yarn和npm！这两个包管理器的锁文件（yarn.lock和package-lock.json）完全不兼容，混用很容易导致依赖版本混乱、项目运行报错，甚至出现难以排查的bug。
Yarn 3本身就能搞定所有依赖管理操作，你只需要用Yarn的专属命令：
- 安装全部依赖：
yarn install（或者直接敲yarn就行） - 添加新依赖：
yarn add <package-name> - 移除依赖：
yarn remove <package-name>
必须搭配npm install吗？绝对不需要！
Yarn 3是完全独立的包管理器，能100%替代npm的功能，全程用Yarn命令就能顺畅管理项目依赖。如果你的项目里有一些老工具（比如旧版本的Webpack、ESLint）暂时不支持PnP，也可以手动切换回node_modules模式：
在项目根目录的.yarnrc.yml文件里添加一行配置：
nodeLinker: node-modules
然后重新运行yarn install，Yarn就会生成你熟悉的node_modules文件夹了。
内容的提问来源于stack exchange，提问作者cicciosgamino
相关产品推荐
相关产品推荐
