u

notes/前端开发/pnpm/pnpm依赖安装失败.md

@@ -0,0 +1,62 @@
+# 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)
+