你有没有遇过这样的状况？为了节省电脑空间，把 pnpm 的 store 设定在外接硬盘，结果某天没带硬盘出门，或是想换个位置存，pnpm 就开始喷错说找不到目录？甚至把硬盘插回去也怪怪的？
这其实跟 pnpm 独特的运作原理有关。今天我们就来聊聊 pnpm 的“仓库”机制，以及当它“失联”时该如何救回来！
pnpm 到底是怎么省空间的？
在开始修复之前，我们先快速复习一下 pnpm 的省空间魔法。
不同于 npm 会在每个项目的 node_modules 里都复制一份完整的套件，pnpm 使用的是 Content-addressable store (全域仓库) 与 Hard Links (硬链接)。
pnpm 运作方式就是所有的套件档案其实都只会存在你电脑里的 某个“大仓库”，你的项目目录只是透过链接指向这个仓库而已。这样不仅节省硬盘空间，安装速度也快得惊人。
| 项目 | pnpm | npm |
|---|---|---|
| 储存方式 | 全域仓库 (Store) + 硬链接 | 每个项目独立复制 |
| 空间占用 | 极低 (同版本只存一份) | 高 (重复复制) |
| 安装速度 | 快 (建立链接即可) | 慢 (需要解压缩与写入) |
为什么外接硬盘会让 pnpm 喷错？
当你为了省本机 SSD 空间，把 pnpm store 设在外接硬盘时，潜在的坑就出现了：
| 状况 | 说明 |
|---|---|
| 路径失效 | 没插硬盘时，pnpm 找不到原本设定的 store-dir，安装时会直接报错退出。 |
| 硬链接崩溃 | 因为硬链接（Hard Link）不能跨分割区（Partition），如果你的项目在 A 硬盘，仓库在 B 硬盘，pnpm 会被迫改用复制的方式，这反而失去了原本的优势，甚至可能因为快取路径乱掉而导致执行错误。 |
遇到这种情况，我们需要手动来“校正回归”一下。
解决方案一：校正回归，重新设定 Store 路径
如果你决定更换 store 的位置，最直接的方法就是告诉 pnpm 新的仓库在哪里。你可以使用以下指令：
pnpm config set store-dir <你的新目录路径>
例如将 pnpm store 设定使用者家目录下的 ~/.pnpm-store：
pnpm config set store-dir ~/.pnpm-store
如果你不确定目前的 store 设定在哪，可以先查询：
pnpm store path
设定完成后，pnpm 就会知道以后要往哪里去抓套件了。
解决方案二：砍掉重练，重新建立链接
有时候改完路径，项目还是会有一些旧的残留错误。这时候“砍掉重练”通常是最有效的药方：
| 步骤 | 说明 |
|---|---|
| 1 | 删除项目中的 node_modules 资料夹。 |
| 2 | 删除 pnpm-lock.yaml（如果是因为路径引起的奇怪错误，建议锁档也重产）。 |
| 3 | 执行 pnpm install 重新建立链接。 |
这会强迫 pnpm 根据你最新的配置，重新从 store 中拉出正确的链接到你的项目里。
如何分配才最順？
如果你常在不同环境切换，或是担心外接硬盘不稳定，最理想的配置是：将 pnpm store 放在本机 SSD，而项目代码可以放外接硬盘。
为什么？因为 store 通常不会变动得太频繁，且体积虽然有，但分散在各项目的总和其实比 npm 小很多。保持仓库在稳定的本机路径（例如 macOS 预设的 ~/Library/pnpm/store），能让你就算没带外接硬盘，也能在其他地方顺利初始化新项目。
这种 Stateless（无状态）的开发概念，能让你的开发环境更具弹性！
结论：保持 Store 的稳定性就是省麻烦
管理 pnpm store 的重点在于“稳定”二字。如果你遇到了路径问题，可以这样做：
| 步骤 | 说明 |
|---|---|
| 1 | 先检查并更换 store-dir 设定。 |
| 2 | 清理一下旧的套件：pnpm store prune（这可以帮你清除没人在用的套件档案，帮硬盘瘦身） |
| 3 | 重新安装套件 pnpm install |
希望这篇文章能帮大家跳出 pnpm 路径的坑，享受极速开发的乐趣！