Мотивація
Заощадження дискового простору#
При використанні npm, якщо у вас є 100 проєктів, що використовують якусь залежність, ви будете мати 100 копій цієї залежності на диску. У pnpm залежність буде зберігатися в адресованому за вмістом сховищі, тому:
- Якщо ви використовуєте різні версії залежностей, до сховища будуть додані лише ті файли, які відрізняються. Наприклад, якщо залежність має 100 файлів, і нова версія має зміну лише в одному з цих файлів,
pnpm updateдодасть тільки 1 новий файл в сховище, замість клонування всієї залежності. - Всі файли збережені в одному місці на диску. 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 виконує встановлення в три етапи:
- Розвʼязання залежностей. Усі необхідні залежності ідентифікуються та завантажуються до сховища.
- Розрахунок структури тек. Структура теки
node_modulesобчислюється на основі залежностей. - Звʼязування залежностей. Всі інші залежності витягуються зі сховища і для них створюються жорсткі посилання на
node_modules.
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.
Створення не пласкої теки node_modules#
При встановленні залежностей за допомогою npm або Yarn Classic всі пакунки підіймаються у корінь теки модулів. В результаті вихідний код має доступ до залежностей, які не додаються як залежності до проєкту.
Стандартно pnpm використовує символічні посилання для додавання лише прямих залежностей проєкту до кореня теки модулів.
Якщо вам потрібно більше деталей про унікальну структуру 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.