Node.js-модуль (node_modules) · Node.js module / node_modules
Модуль Node.js — единица кода, подключаемая через require() или import; также node_modules — каталог с локально установленными пакетами.
Подробно
В Node.js модуль — это отдельный файл или пакет, изолирующий код и экспортирующий наружу только нужные сущности через module.exports/require (CommonJS) либо export/import (ESM). Node встроил модульную систему с самого начала: есть встроенные модули (`node:fs`, `node:path`, `node:http`) и сторонние пакеты из npm. При установке зависимости (`npm install`) пакеты складываются в каталог node_modules в корне проекта, откуда резолвер Node ищет их по цепочке вверх. Каталог node_modules не коммитят в Git — он воспроизводится из package.json и lock-файла (package-lock.json / yarn.lock / pnpm-lock.yaml). Понимание резолюции модулей, ESM-протокола `node:` и поля `type` в package.json необходимо при отладке ошибок вида «Cannot find module».
Примеры употребления
- const fs = require('node:fs');
- import { readFile } from 'node:fs/promises';
- npm install express # пакет появится в ./node_modules/express
- Ошибка Error: Cannot find module 'lodash' — обычно забыт npm install или неверный путь резолюции