Мотивація

Заощадження дискового простору#

Ілюстрація сховища з адресованим вмістом pnpm. На ілюстрації представлено два проєкти з 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 додасть тільки 1 новий файл в сховище, замість клонування всієї залежності.
  2. Всі файли збережені в одному місці на диску. When packages are installed, their files are hard-linked or cloned (copy-on-write) from that single place, consuming no additional disk space. By default, pnpm copies files only when the filesystem supports neither. See packageImportMethod. Це дозволяє обмінюватися залежностями однієї версії між різними проєктами.

As a result, you save a lot of space on your disk proportional to the number of projects and dependencies, and you have a lot faster installations.

Прискорює встановлення#

pnpm виконує встановлення в три етапи:

  1. Розвʼязання залежностей. Усі необхідні залежності ідентифікуються та завантажуються до сховища.
  2. Розрахунок структури тек. Структура теки node_modules обчислюється на основі залежностей.
  3. Звʼязування залежностей. Всі інші залежності витягуються зі сховища і для них створюються жорсткі посилання на node_modules.

Ілюстрація процесу встановлення pnpm. Packages are resolved, fetched, and hard linked as soon as possible.

Each package moves to the next stage as soon as it is ready, without waiting for the other packages. This is faster than the traditional three-stage installation process, which resolves all dependencies, then fetches all of them, then writes all of them to node_modules.

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

Створення не пласкої теки node_modules#

При встановленні залежностей за допомогою npm або Yarn Classic всі пакунки підіймаються у корінь теки модулів. В результаті вихідний код має доступ до залежностей, які не додаються як залежності до проєкту.

Стандартно pnpm використовує символічні посилання для додавання лише прямих залежностей проєкту до кореня теки модулів.

Ілюстрація теки node_modules, створеної pnpm. Packages in the root node_modules are symlinks to directories inside the node_modules/.pnpm directory

Якщо вам потрібно більше деталей про унікальну структуру node_modules, яку створює pnpm, і чому вона добре працює з екосистемою Node.js, прочитайте:

підказка

If your tooling doesn't work well with symlinks, you may still use pnpm and set the nodeLinker setting to hoisted. Це дозволить pnpm створити теку node_modules, подібну до тек, створених npm та Yarn Classic.