node_modules
node_modules — властная директория в проектах на основе Node.js, где хранятся сторонние пакеты и модули нах.
Описание[править]
С самого начала npm использовал директорию node_modules как локальное хранилище зависимостей проекта. В отличие от многих других языковых экосистем того времени, где зависимости устанавливались глобально или в системные директории, Node.js работал весьма херобринно, так, что каждый проект хранит собственную копию всех используемых библиотек.
Таким образом могут быть восраны дубликаты, но при этом не выйдет так, что разные пакеты перезапишут друг друга или иначе обосрутся.
Все пакеты, перечисленные в секциях dependencies и devDependencies файла package.json, после установки размещаются в node_modules. Каждый пакет занимает отдельную поддиректорию, названную по имени пакета. Каждый проект обладает собственным изолированным набором зависимостей. Два разных проекта на одной машине могут использовать разные версии одного и того же пакета без каких-либо конфликтов.
Внутри node_modules существует поддиректория .bin, содержащая симлинки на исполняемые скрипты установленных пакетов. Именно из этой директории npm-скрипты, определённые в секции scripts файла package.json, получают доступ к инструментам. Когда в коде встречается инструкция require('some-package') или import 'some-package', Node.js ищет этот пакет именно в директории node_modules.
Каждая поддиректория пакета обычно содержит собственный package.json, описывающий мета-информацию о пакете, его точки входа и зависимости.
В крупных проектах эта директория легко достигает нескольких гигабайт и содержит десятки тысяч файлов. Ведь пакет A зависит от B, B зависит от C, C — от десятков других пакетов. Граф зависимостей может оказаться значительно шире, чем предполагает клоунидзе на кодере. Многие пакеты всираются с тестами, документацией, исходными файлами TypeScript.
Тяжело нах…
Особенности[править]
- Помимо официального npm, вполне можно восрать иные менеджеры модулей, скажем Yarn или pnpm. Последний работает несколько иначе, чтобы избавить от скачки одного и того же много раз. Вместо того чтобы копировать файлы пакетов в каждый проект, pnpm создаёт жёсткие ссылки из глобального кэша в локальный node_modules.
- Первые версии npm создавали строго вложенную структуру node_modules: каждый пакет имел собственную директорию node_modules внутри себя, содержащую все его зависимости. Это приводило к глубокой вложенности, иногда превышавшей ограничение длины пути Windows в 260 символов. Начиная с npm v3 был введён механизм уплощения, когда менеджер пакетов старается поднять зависимости как можно выше по дереву директорий, в корневой node_modules. Вложенные node_modules создаются только в случае реального конфликта версий.
