Windows 使用 pnpm 实现依赖共享与磁盘空间节省教程（附完整 .npmrc 配置）

在日常开发中，node_modules 常常是项目中最占空间的文件夹之一。你是否遇到过硬盘空间越来越紧张、多个项目重复安装同一个依赖的问题？这时候，你可能需要一位更聪明的包管理器——pnpm。

本文将从 Windows 用户视角，手把手配置 pnpm，并把依赖缓存目录统一迁移到一个指定位置，比如 D:\cache\pnpm，大幅节省磁盘空间。

🔍 为什么选择 pnpm？

与 npm 和 yarn 不同，pnpm 使用硬链接机制来共享依赖，避免重复下载，优势非常明显：

✅ 安装 pnpm（Windows）

如果你的机器已经装了 Node.js，可以直接用 npm 安装：

npm install -g pnpm

安装完后，执行 pnpm -v 确认是否成功。

📁 统一缓存目录到 D 盘（节省空间）

默认情况下，pnpm 会把缓存存在类似下面的路径：

C:\Users\你的用户名\AppData\Local\pnpm-store

你可以把它改成 D 盘或其它盘，比如：

pnpm config set store-dir D:\cache\pnpm

这条命令会将 pnpm 的全局依赖缓存目录迁移到 D:\cache\pnpm，从此所有项目都共用一份依赖缓存，节省大量空间。

📦 设置镜像源：使用 npmmirror 加速安装

在国内开发环境中，推荐使用淘宝镜像，加快依赖下载：

pnpm config set registry https://registry.npmmirror.com

🧰 完整 .npmrc 配置示例（推荐写法）

你可以在用户目录（C:\Users\你的用户名\.npmrc）或项目根目录配置以下内容：

cache=D:\cache\npm
registry=https://registry.npmmirror.com
store-dir=D:\cache\pnpm
shamefully-hoist=true

配置说明：

• cache：npm 自身的缓存目录（对 pnpm 无影响）；
• registry：镜像源地址；
• store-dir：pnpm 的依赖缓存目录（重点！）；
• shamefully-hoist：让 pnpm 行为更接近 npm，提升兼容性（比如老项目使用 require('xxx') 不报错）。

🧪 检查是否配置成功

运行以下命令检查：

pnpm config get store-dir
pnpm config get registry

输出应为你设置的路径和镜像源。

🧹 可选：清理旧缓存

如果你之前已经用过 pnpm，可以清理旧缓存：

pnpm store prune

也可以手动删除 C:\Users\你的用户名\AppData\Local\pnpm-store。

🎁 Bonus：项目初始化建议

如果你从 npm 切换到 pnpm，建议执行以下操作一次性清理并重装：

rm -rf node_modules package-lock.json
pnpm install

此后项目将使用 pnpm-lock.yaml 来记录依赖版本。

✅ 总结

使用 pnpm 配合合理的缓存路径设置，不仅能提升依赖安装速度，还能大幅节省磁盘空间，尤其在多个项目并行开发时，优势明显。

📌 强烈建议 Windows 用户将依赖缓存统一迁移到 D 盘或非系统盘，保持系统盘干净。