Yarn 3执行install后node_modules为空，npx脚本运行失败

核心问题：Yarn Berry 默认启用**PnP（Plug'n'Play）**模式，该模式不需要生成传统的node_modules目录，依赖直接通过Yarn的解析机制加载，这就是你看到node_modules为空的原因。

解决方案一：切换回传统node_modules模式 #

如果习惯使用node_modules，可以修改项目的yarnrc.yml，添加如下配置：

nodeLinker: node-modules

保存后重新执行：

yarn install

此时会生成标准的node_modules目录，原有脚本（无论是yarn run还是npx）都能正常运行。

解决方案二：适配PnP模式（推荐） #

PnP是Yarn Berry的核心特性，能提升依赖安装速度和磁盘利用率，适配步骤如下：

• 执行脚本时统一使用yarn run <脚本名称>，不要直接用npx，Yarn会自动处理依赖路径解析
• 如果必须使用npx，先安装PnP兼容工具：

  yarn add -D @yarnpkg/pnpify
  

  然后通过pnpify包装执行：

  yarn pnpify npx <你的命令>
  

• 编辑器/IDE需安装PnP支持插件（比如VSCode的Yarn PnP插件），避免代码提示异常

额外检查点 #

• 确认用户目录下的.yarnrc中的npm令牌配置未被项目级yarnrc.yml覆盖，Yarn Berry会自动读取用户级配置
• 迁移后项目根目录应该生成.pnp.cjs和.yarn目录，若缺失可重新执行yarn install触发完整迁移

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