pnpm 之所以能顯著節省磁盤空間，主要基于其獨特的硬鏈接（Hard Link）與符號鏈接（Symbolic Link）機制，結合全局內容尋址存儲（Content-Addressable Storage） 的設計。以下是具體原理分步解析：

1. 全局共享存儲：避免重復安裝

• 核心機制：pnpm 在磁盤上創建統一的全局倉庫（如 ~/.pnpm-store），所有依賴包按內容哈希值（唯一標識）存儲于此。  

當多個項目使用同一版本的依賴包時，pnpm 不會在每個項目中重復復制文件，而是通過硬鏈接從全局倉庫指向項目內的 node_modules 目錄。  

硬鏈接本質是同一文件數據的多個入口，所有鏈接指向相同的物理磁盤位置。因此，無論多少項目引用同一依賴，磁盤上僅保留一份原始文件副本。

• 實際效果：假設 100 個項目依賴 lodash@4.17.21，npm 會存儲 100 份副本（占用 100 × 包大小），而 pnpm 僅存儲 1 份，其余項目通過硬鏈接復用，節省 99% 的磁盤空間。

2. 增量更新：僅存儲差異內容

• 版本更新優化：當依賴包升級時（如 lodash@4.17.21 → 4.17.22），pnpm 僅將新增或修改的文件寫入全局倉庫，未變動的文件仍通過硬鏈接復用舊版本。  

例如：若新版本僅修改了 1 個文件（原版本有 100 個文件），則 pnpm 保留 99 個文件的硬鏈接，僅新增 1 個文件，而非完整重寫 101 個文件。

• 對比 npm：npm 每次更新依賴時需下載完整新包并替換舊包，導致冗余存儲。

3. 非扁平化 node_modules：精準鏈接依賴

• 結構設計：pnpm 的 node_modules 采用嚴格的嵌套結構：  

所有依賴以符號鏈接形式存在，實際文件存儲在 .pnpm 子目錄中（該目錄硬鏈接到全局倉庫）。  

每個包的依賴被隔離在其專屬目錄內，避免未聲明依賴被意外訪問（即解決“幽靈依賴”問題）。

• 空間影響：符號鏈接僅占用極小元數據空間（約幾十字節），而 npm 的扁平化結構需復制整個依賴樹，即使依賴重復也需獨立存儲。

4. 內容尋址存儲：哈希值唯一標識文件

• 文件級去重：全局倉庫中，每個文件以其內容的哈希值命名。若不同包包含相同文件（如 LICENSE 文件），僅存儲一次，通過硬鏈接共享。  

例如：10 個包都包含相同的 LICENSE 文件，磁盤僅保留一份。

實際節省效果對比

場景  npm 占用空間  pnpm 占用空間  

100 個項目同用 lodash  100 × 包大小  1 × 包大小 依賴包更新（1 文件變動）  完整新副本  僅新增 1 文件  

注意事項

• 兼容性：極少數依賴包可能因文件結構差異無法在 pnpm 中運行（需配置 shamefully-hoist=true 臨時提升依賴）。  
• 清理機制：定期運行 pnpm store prune 可刪除全局倉庫中未被任何項目引用的包。

總結

pnpm 通過硬鏈接復用全局文件、符號鏈接構建隔離依賴樹、內容尋址實現文件級去重，在保證依賴安全隔離的同時，徹底消除冗余存儲。尤其適合多項目環境（如 Monorepo）或依賴量大的場景，磁盤空間節省可達 50%~90%。