跳至主要內容
版本：下一個

動機

節省儲存空間​

An illustration of the pnpm content-addressable store. On the illustration there are two projects with node_modules. The files in the node_modules directories are hard links to the same files in the content-addressable store.

使用 npm 時，若您有 100 件專案都使用了同個依附套件，磁碟中就會有 100 份該套件的副本。 反之，有了 pnpm，該依附套件會被儲存在一個由內容定址的儲存區，因此：

  1. 如果您同時需要該依附套件的不同版本，只有存在差異的檔案才會被加入儲存區。 例如，如果此依賴套件有 100 個檔案，而新的 版本僅變更其中一個檔案，則 pnpm update 將只會新增一個 新的檔案到儲存庫中，而不會為了單一檔案的變更而複製整個依賴套件。
  2. 所有依賴套件的檔案將被儲存在磁碟中的單一位置。 當依賴套件被 安裝時，依賴套件的檔案會被硬鏈結至該位置，不會消耗 額外的磁碟空間。 這將允許您在不同專案之間共享相同版本的依賴套件。

由於上述原因，您將節省大量的磁碟空間，這將與您的 專案和依賴套件的數量成正比，並且將大幅提升安裝的速度！

加速安裝​

pnpm 安裝套件的程序有三個階段：

  1. 解析相依性。 辨識並取得所有需要的相依套件後，將它們置於儲存區。
  2. 計算目錄結構。 依照相依性計算出 node_modules 的目錄結構。
  3. 建立連結。 取得所有剩餘的相依套件後，將其從儲存區硬連結至 node_modules。

An illustration of the pnpm install process. Packages are resolved, fetched, and hard linked as soon as possible.

對比傳統安裝套件的三階段：解析相依性、取得套件、將其全部寫入至 node_modules。pnpm 的方式顯著地提升了安裝速度。

An illustration of how package managers like Yarn Classic or npm install dependencies.

Creating a non-flat node_modules directory​

When installing dependencies with npm or Yarn Classic, all packages are hoisted to the root of the modules directory. As a result, source code has access to dependencies that are not added as dependencies to the project.

By default, pnpm uses symlinks to add only the direct dependencies of the project into the root of the modules directory.

An illustration of a node_modules directory created by pnpm. Packages in the root node_modules are symlinks to directories inside the node_modules/.pnpm directory

If you'd like more details about the unique node_modules structure that pnpm creates and why it works fine with the Node.js ecosystem, read:

提示

If your tooling doesn't work well with symlinks, you may still use pnpm and set the node-linker setting to hoisted. This will instruct pnpm to create a node_modules directory that is similar to those created by npm and Yarn Classic.