Перейти к основному содержимому
Версия: 8.x

pnpm vs npm

npm's flat tree

npm maintains a flattened dependency tree as of version 3. This leads to less disk space bloat, with a messy node_modules directory as a side effect.

On the other hand, pnpm manages node_modules by using hard linking and symbolic linking to a global on-disk content-addressable store. This lets you get the benefits of far less disk space usage, while also keeping your node_modules clean. There is documentation on the store layout if you wish to learn more.

The good thing about pnpm's proper node_modules structure is that it "helps to avoid silly bugs" by making it impossible to use modules that are not specified in the project's package.json.


pnpm does not allow installation of packages without saving them to package.json. If no parameters are passed to pnpm add, packages are saved as regular dependencies. Like with npm, --save-dev and --save-optional can be used to install packages as dev or optional dependencies.

As a consequence of this limitation, projects won't have any extraneous packages when they use pnpm unless they remove a dependency and leave it orphaned. That's why pnpm's implementation of the prune command does not allow you to specify packages to prune - it ALWAYS removes all extraneous and orphaned packages.

Каталог зависимостей

Зависимости каталогов начинаются с префикса file: и указывают на каталог в файловой системе. Как и npm, pnpm символически связывает эти зависимости. Но в отличие от npm, pnpm не выполняет установку зависимостей файлов.

Это значит, что если у вас есть пакет с именем foo (<root>/foo), который имеет bar@file:../bar в качестве зависимости, pnpm не будет выполнять установку для <root>/bar, когда вы запускаете pnpm install на foo.

Если вам нужно устанавливать зависимости в нескольких пакетах одновременно, например, в случае монорепозитория, то смотрите документацию по pnpm -r.