# 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)