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.