Files
workspace/notes/前端开发/pnpm/pnpm依赖安装失败.md
T
2025-08-06 15:04:01 +08:00

63 lines
1.7 KiB
Markdown

# 1 软链接问题解决
**问题**: `pnpm` 使用硬链接或符号链接来管理 `node_modules` 中的依赖项。如果链接路径在新的文件夹或文件系统中失效,可能会导致依赖解析失败。
**解决方法**: 尝试删除并重新安装所有依赖,确保链接正确创建。
```bash
rm -rf node_modules pnpm-lock.yaml
```
# 2 文件路径过长问题
**问题**: 在 Windows 系统上,文件路径过长(超过 260 个字符)可能导致文件系统问题,导致文件无法被正确访问。
**解决方法**: 尝试将项目目录移动到一个路径较短的位置,比如 `C:\Projects\my-project`,然后重新安装依赖。
node_modules文件夹里面的内容路径会很长,所以整个项目文件夹所在路径不宜过长,否则路径可能会超过260个字符。
![image-20240830135718984](./assets/pnpm%E4%BE%9D%E8%B5%96%E5%AE%89%E8%A3%85%E5%A4%B1%E8%B4%A5/6c3a3b402b47e6e5998e6239da67188a-1754458316963-17.png)
# 3 pnpm缓存问题
**问题**: `pnpm` 的缓存可能导致一些包没有被正确更新或安装。
**解决方法**: 清除 `pnpm` 的缓存:
依次执行下面命令
- 清理未使用的缓存包
```bash
pnpm store prune
```
- 清空整个 pnpm 的缓存存储库
```bash
pnpm store clear
```
# 4 pnpm缓存深度清理
执行下面这句话:
```bash
pnpm store path
```
然后我们看到这个路径
![image-20240830140127029](./assets/pnpm%E4%BE%9D%E8%B5%96%E5%AE%89%E8%A3%85%E5%A4%B1%E8%B4%A5/a56241f28b0f24d39eca14fa0193e348-1754458408503-20.png)
进入这个目录,将这3个文件夹都手动删除
![image-20240830140240181](./assets/pnpm%E4%BE%9D%E8%B5%96%E5%AE%89%E8%A3%85%E5%A4%B1%E8%B4%A5/c7d9e09d22a867a60add460abf35c54a-1754458408503-22.png)