pnpm全局存储的效果是什么，如何实现的

[leno23]

pnpm 全局存储的效果

1. 节省磁盘空间

传统 npm/yarn：
项目A/node_modules/react (100MB)
项目B/node_modules/react (100MB)  
项目C/node_modules/react (100MB)
总共：300MB

pnpm：
全局存储/react (100MB)
项目A/node_modules/react -> 硬链接
项目B/node_modules/react -> 硬链接
项目C/node_modules/react -> 硬链接
总共：100MB

2. 安装速度更快

• 第一次安装包时下载到全局存储
• 后续任何项目需要这个包，直接创建硬链接（几乎瞬间完成）
• 不需要重复下载和解压

3. 更严格的依赖管理

• 只有声明的依赖才能被访问
• 避免"幽灵依赖"（phantom dependencies）问题

---

实现原理

📦 存储结构

~/.pnpm-store/v3/files/
├── 00/
│   └── a1b2c3d4... (react 的文件内容)
├── 01/
│   └── e5f6g7h8... (lodash 的文件内容)
└── ...

你的项目/node_modules/
└── .pnpm/
    ├── react@18.2.0/
    │   └── node_modules/
    │       └── react/  (硬链接到全局存储)
    └── lodash@4.17.21/
        └── node_modules/
            └── lodash/  (硬链接到全局存储)

🔗 硬链接（Hard Link）机制

什么是硬链接？

• 硬链接是文件系统层面的特性
• 多个文件路径指向同一个物理存储位置（inode）
• 不是复制，而是引用同一份数据

# 示意图
全局存储的 react 文件
    ↑
    ├── 项目A 的 react (硬链接) 
    ├── 项目B 的 react (硬链接)
    └── 项目C 的 react (硬链接)
    
所有项目共享同一份物理文件，但看起来各有一份

🔍 三层结构

pnpm 使用三层 node_modules 结构：

your-project/
└── node_modules/
    ├── .pnpm/                          # 实际存储（硬链接到全局）
    │   ├── react@18.2.0/
    │   │   └── node_modules/
    │   │       ├── react/              # 硬链接 → 全局存储
    │   │       └── loose-envify/       # react 的依赖
    │   └── lodash@4.17.21/
    │       └── node_modules/
    │           └── lodash/             # 硬链接 → 全局存储
    │
    ├── react -> .pnpm/react@18.2.0/node_modules/react      # 符号链接
    └── lodash -> .pnpm/lodash@4.17.21/node_modules/lodash  # 符号链接

三层的作用：

1. 第一层 (node_modules/react)：符号链接，你代码中 import 的是这层
2. 第二层 (.pnpm/react@18.2.0/)：扁平化依赖结构
3. 第三层 (全局存储)：硬链接指向的真实文件

---

与 npm/yarn 的对比

特性	npm/yarn	pnpm
存储方式	每个项目独立复制	全局存储 + 硬链接
磁盘占用	高（重复存储）	低（共享存储）
安装速度	慢（重复下载解压）	快（链接已有文件）
依赖访问	可访问未声明的依赖	严格，只能访问声明的
node_modules 结构	扁平化（flat）	嵌套 + 链接

---

实际效果举例

假设你的电脑上有 10 个项目都用了相同版本的常见包：

# npm/yarn 磁盘占用
10 个项目 × 500MB = 5GB

# pnpm 磁盘占用
全局存储 500MB + 少量链接开销 ≈ 550MB

节省了约 90% 的空间！

---

验证方式

你可以在项目中验证：

# 查看 pnpm 全局存储位置
pnpm store path

# 查看存储状态
pnpm store status

# 清理未使用的包
pnpm store prune

这就是 pnpm 被称为"高性能的 npm"的原因——通过巧妙的文件系统特性实现了空间和速度的双重优化！