排查实际有文件但报错 Error: Cannot find package
解决步骤
- 根
.npmrc增加配置virtual-store-dir-max-length=60限制依赖目录名称最大长度。 - 在项目根目录递归清空
node_modules目录内容。 - 删除项目根目录锁文件。
- 项目根目录执行 pnpm i 拉取依赖。
- 本地再跑项目
问题描述
背景：
- windows-11、node-v20.20.0、项目级 pnpm-9.15.0
- pnpm monorepo 项目结构
.npmrc配置node-linker=isolated- 根目录 vite 启动某个应用
报错：
排查实际有文件但报错 Error: Cannot find package
问题原因
不是代码的问题，是 node_modules/.pnpm 中路径长度的问题。
防止多版本冲突，node_modules/.pnpm会弄个包含所有版本和依赖项哈希的超长名字，这个路径过长。
导致：node 解析时失败 -> 当作包名处理 -> 报错 Cannot find package。
类似 Powershell 访问超长路径失败，但 node 没有类似的 LongPathsEnabled 设置。
.npmrc 测试修改配置 node-linker=hoisted 能够解决，是因为这种模式 node_modules 内结构与 npm 类似，依赖被提升到根目录的 node_modules，但是又会有 npm 的依赖问题。
待项目依赖版本融合后也许可用该配置解决。但还是建议保持 node-linker=isolated。
根 .npmrc 增加配置 virtual-store-dir-max-length=60 限制依赖目录名称最大长度，就可以解决该问题了。
虽然 pnpm 文档写有默认设置，但实际文件加了配置才生效。
https://pnpm.io/zh/settings#virtualstoredirmaxlength
