pnpm 存储位置统一，解决磁盘空间焦虑

文章目录

引言
[为什么需要统一 pnpm 存储位置](#为什么需要统一 pnpm 存储位置)
[核心解决方案：统一 store 路径](#核心解决方案：统一 store 路径)
实战：迁移现有存储
常见问题排查
最佳实践总结
写在最后

引言

作为一个每天都在和 Node.js 打交道的开发者，你是否遇到过这样的困扰：

明明 pnpm 号称可以节省磁盘空间，为什么每个项目下的 node_modules 还是那么大？
在多个项目中反复 pnpm install，感觉硬盘空间在以肉眼可见的速度减少
公司配的 256G 笔记本，光是 node_modules 就占了 80 多 G

如果你有以上任何一个痛点，那么恭喜你，这篇文章正是为你准备的。

为什么需要统一 pnpm 存储位置

pnpm 相比 npm 和 yarn 最大的优势之一就是节省磁盘空间。它使用内容可寻址存储的方式，将所有依赖包平铺存储在磁盘的某个位置，然后通过硬链接将文件链接到各个项目的 node_modules 中。

然而，很多开发者在实际使用中并没有享受到这个优势，原因往往是：pnpm 的默认存储位置分散在不同地方。

默认情况下：

macOS/Linux : ~/.local/share/pnpm/store
Windows : ~/AppData/Local/pnpm/store

但如果你的项目分布在不同的磁盘分区，pnpm 会为每个分区创建一个独立的 store，导致依赖包被重复下载和存储。

核心解决方案：统一 store 路径

方案一：通过配置文件永久设置（推荐）

创建或编辑 ~/.npmrc 文件：

bash 复制代码

# 设置统一的存储路径（以 D 盘为例）
store-dir = D:/.pnpm-store

# 可选：设置全局包安装路径
global-dir = D:/.pnpm-global
global-bin-dir = D:/.pnpm-global/bin

对于项目级别的 .npmrc 配置：

ini 复制代码

# 项目根目录下的 .npmrc
store-dir = D:/.pnpm-store

小贴士：为了让所有项目都生效，建议在用户目录下配置全局 .npmrc。

方案二：通过环境变量设置

bash 复制代码

# Windows PowerShell
[Environment]::SetEnvironmentVariable("PNPM_HOME", "D:\.pnpm-store", "User")
[Environment]::SetEnvironmentVariable("PNPM_STORE_PATH", "D:\.pnpm-store", "User")

# macOS/Linux
echo 'export PNPM_HOME="$HOME/.pnpm-store"' >> ~/.zshrc
echo 'export PNPM_STORE_PATH="$HOME/.pnpm-store"' >> ~/.zshrc
source ~/.zshrc

方案三：命令行临时设置

bash 复制代码

# 单次命令指定存储路径
pnpm install --store-dir D:/.pnpm-store

# 设置全局配置
pnpm config set store-dir D:/.pnpm-store

实战：迁移现有存储

第一步：查看当前存储位置

bash 复制代码

pnpm store path

第二步：迁移已有依赖

bash 复制代码

# 方案 A：直接移动文件夹（Windows）
# 关闭所有使用 pnpm 的应用
move %APPDATA%\Local\pnpm\store D:\.pnpm-store

# 方案 B：使用 pnpm 命令迁移（推荐）
pnpm config set store-dir D:/.pnpm-store
pnpm store prune  # 清理未使用的包
pnpm store add    # 重新添加依赖

第三步：验证迁移结果

bash 复制代码

pnpm store path
# 输出应为：D:/.pnpm-store/v3

高级技巧：多盘符环境优化

对于开发环境复杂的场景，可以考虑以下策略：

符号链接方案

bash 复制代码

# 将默认位置软链接到目标位置
# Windows（管理员权限）
mklink /J %APPDATA%\Local\pnpm\store D:\.pnpm-store

# macOS/Linux
ln -s ~/.pnpm-store ~/.local/share/pnpm/store

按项目类型分流

bash 复制代码

# 大型项目使用 SSD 存储
store-dir = C:/.pnpm-store-fast

# 存档项目使用 HDD 存储
store-dir = E:/.pnpm-store-archive

常见问题排查

❌ 问题1：权限不足

bash 复制代码

# Windows
# 以管理员身份运行 PowerShell

# macOS/Linux
sudo chown -R $USER ~/.pnpm-store

❌ 问题2：硬链接失败

如果目标存储分区与项目不在同一磁盘：

bash 复制代码

# 启用 copy-on-write 或复制模式
pnpm install --package-import-method copy

❌ 问题3：CI/CD 环境优化

yaml 复制代码

# GitHub Actions 示例
- name: Setup pnpm
  uses: pnpm/action-setup@v2
  with:
    version: 8
    run_install: false

- name: Set pnpm store path
  run: |
    pnpm config set store-dir ~/.pnpm-store

- name: Cache pnpm store
  uses: actions/cache@v3
  with:
    path: ~/.pnpm-store
    key: ${{ runner.os }}-pnpm-${{ hashFiles('**/pnpm-lock.yaml') }}

最佳实践总结

优先使用配置文件方式，确保所有项目行为一致
将 store 放在读写速度较快且空间充足的磁盘
定期执行 pnpm store prune 清理无用包
结合 CI/CD 缓存策略，加速构建过程
团队统一规范，通过 .npmrc 文件共享配置

写在最后

统一 pnpm 存储位置看似是一个小操作，但它带来的收益却是实打实的。

如果你还在为磁盘空间发愁，不妨现在就行动起来。记住：一次配置，永久受益。