使用yarn@4.6.0装包,项目是react+vite搭建的,项目无法启动,报错:

✘ [ERROR] Cannot read file: E:/source/m-apps/my-vite-app/.yarn/virtual/react-dom-virtual-81b5a735d4/5/C:/Users/13796/AppData/Local/Yarn/Berry/cache/react-dom-npm-19.2.0-10246904d4-10c0.zip/node_modules/react-dom/client.js

AI的回答:

bash 复制代码
这是一个在 Windows 上用 Yarn PnP + 全局缓存 + esbuild/Vite 时的已知路径问题:Yarn 会把依赖的 zip 放在全局缓存目录(C 盘用户目录),PnP 生成的虚拟路径里会出现类似
E:/.../.yarn/__virtual__/.../5/C:/Users/.../cache/...zip/node_modules/...
这种"盘符嵌套"的路径,esbuild 无法识别,导致 Cannot read file。

最简单可行的修复方案(任选其一):

方案 A(推荐):关闭 Yarn 的全局缓存
1) 在项目根目录的 .yarnrc.yml 中加入/修改:
   enableGlobalCache: false
2) 清理并重装依赖:
   - 删除 .yarn/cache(如果有)
   - yarn cache clean
   - yarn install
3) 重新启动 Vite。

方案 B:改用 node_modules 链接器(暂避开 PnP)
1) 在 .yarnrc.yml 中设置:
   nodeLinker: node-modules
2) yarn install
3) 重新启动 Vite。

方案 C:仅把有问题的包解压到本地(unplug)
1) 运行:
   yarn unplug react react-dom
   或在 package.json 增加:
   "dependenciesMeta": {
     "react": { "unplugged": true },
     "react-dom": { "unplugged": true }
   }
2) yarn install
3) 重新启动 Vite。

备注
- 方案 A 的原理是让依赖的 zip 放在项目本地 .yarn/cache(与你的项目同盘符),避免路径里混入 C: 盘导致 esbuild 解析失败。
- 保持 Yarn PnP 的同时,A 通常就能解决问题;如果你更倾向于兼容性优先,B 最省心。
- 如果依然报错,确认 Node 版本为 18+/20+,并升级 Vite 和 esbuild 到较新版本,然后重新安装依赖。

需要我看下你的 .yarnrc.yml、package.json 和 Vite 版本,我可以给出更精确的配置。

我的选择:

在根目录下添加文件.yarnrc.yml

.yarnrc.yml:

bash 复制代码
enableImmutableInstalls: false

httpTimeout: 300000

nodeLinker: node-modules

enableScripts: false

AI对各个字段含义的解释:

bash 复制代码
下面分别说明这些 .yarnrc.yml 配置项的作用、默认值与影响:

- enableImmutableInstalls: false
  - 含义:允许安装过程中修改 yarn.lock/.pnp.* 等(即不强制"只读安装")。
  - 默认:false(在 CI 环境通常会用 --immutable 或显式设为 true)。
  - 影响:便于本地开发自动更新锁文件;在 CI 中通常应开启以防依赖漂移。

- httpTimeout: 300000
  - 含义:每个 HTTP 请求(如拉取包、元数据)的超时时间,单位毫秒。
  - 默认:30000(30 秒)。
  - 影响:设为 300000 即 5 分钟,适合网络较慢或有代理的环境,减少超时失败。

- nodeLinker: node-modules
  - 含义:使用 node_modules 安装模式,而不是 Yarn 默认的 Plug'n'Play (pnp)。
  - 默认:pnp。
  - 影响:会生成并"提升"node_modules,兼容依赖 node_modules 的工具链,但磁盘占用更大、安装/解析可能更慢,失去 PnP 的一致性/性能优势。

- enableScripts: false
  - 含义:禁用安装阶段执行依赖包的生命周期脚本(preinstall/install/postinstall/prepare 等)。
  - 默认:true。
  - 影响:提升安全性与可重复性,但可能导致需要编译/下载二进制的包无法正常安装(如 node-gyp、sharp、esbuild 等)。你项目自身的脚本可通过 yarn run 手动执行;如需在禁用情况下仅允许部分包执行脚本,可配合 yarn-plugin-allow-scripts 白名单使用,或用环境变量 YARN_ENABLE_SCRIPTS=1 临时开启。
相关推荐
0思必得023 分钟前
[Web自动化] Selenium处理动态网页
前端·爬虫·python·selenium·自动化
摘星编程35 分钟前
React Native鸿蒙版:Drawer抽屉导航实现
react native·react.js·harmonyos
东东5161 小时前
智能社区管理系统的设计与实现ssm+vue
前端·javascript·vue.js·毕业设计·毕设
catino1 小时前
图片、文件的预览
前端·javascript
2501_920931702 小时前
React Native鸿蒙跨平台实现推箱子游戏,完成玩家移动与箱子推动,当所有箱子都被推到目标位置时,玩家获胜
javascript·react native·react.js·游戏·ecmascript·harmonyos
layman05283 小时前
webpack5 css-loader:从基础到原理
前端·css·webpack
半桔3 小时前
【前端小站】CSS 样式美学:从基础语法到界面精筑的实战宝典
前端·css·html
AI老李3 小时前
PostCSS完全指南:功能/配置/插件/SourceMap/AST/插件开发/自定义语法
前端·javascript·postcss
_OP_CHEN3 小时前
【前端开发之CSS】(一)初识 CSS:网页化妆术的终极指南,新手也能轻松拿捏页面美化!
前端·css·html·网页开发·样式表·界面美化
啊哈一半醒3 小时前
CSS 主流布局
前端·css·css布局·标准流 浮动 定位·flex grid 响应式布局