Менеджер пакетов npm

Зачем писать код с нуля, если кто-то уже написал его лучше вас? npm — это гигантский каталог готовых библиотек для JavaScript. Узнаем, как управлять зависимостями проекта и не изобретать велосипед каждый раз.

🌍 Что такое npm и зачем он нужен?

Представьте, что вам нужно построить дом. Можно пилить доски вручную, лепить кирпичи из глины и варить сталь для гвоздей. А можно купить готовые стройматериалы в магазине и потратить силы на само строение. npm — это такой магазин для программистов.

npm расшифровывается как Node Package Manager — менеджер пакетов для Node.js. Сегодня это крупнейший реестр программного обеспечения в мире: более двух миллионов пакетов и миллиарды загрузок в неделю. Хотите работать с датами — вот date-fns. Нужны HTTP-запросы — вот axios. Сложные утилиты для массивов — вот lodash.

npm устанавливается вместе с Node.js. Если у вас уже установлен Node.js — npm тоже есть. Проверить версию можно в терминале:

node --version   # v20.11.0 (или любая другая версия)
npm --version    # 10.2.4 (или любая другая версия)

📋 package.json — паспорт проекта

Каждый JavaScript-проект, использующий npm, имеет файл package.json. Это JSON-файл, который хранит всю мета-информацию о проекте: название, версию, автора, список зависимостей и команды для запуска.

Чтобы создать package.json, запустите команду в папке вашего проекта:

npm init          # Интерактивный режим — задаёт вопросы
npm init -y       # Создать с настройками по умолчанию (быстро)

Результат — файл package.json примерно такого содержания:

{
  "name": "my-project",
  "version": "1.0.0",
  "description": "Мой первый проект с npm",
  "main": "index.js",
  "type": "module",
  "scripts": {
    "start": "node index.js",
    "build": "webpack --mode production",
    "test": "jest"
  },
  "dependencies": {
    "axios": "^1.6.0",
    "date-fns": "^3.0.0"
  },
  "devDependencies": {
    "webpack": "^5.89.0",
    "jest": "^29.7.0"
  },
  "author": "Иван Иванов",
  "license": "MIT"
}

⬇️ Установка пакетов

Основные команды, которые вы будете использовать каждый день:

# Установить все зависимости из package.json (например, после git clone)
npm install

# Установить конкретный пакет и добавить в dependencies
npm install axios
npm install date-fns lodash    # можно несколько сразу

# Установить пакет только для разработки (devDependencies)
npm install --save-dev webpack
npm install -D jest            # -D — сокращение от --save-dev

# Установить пакет глобально (доступен в любом проекте)
npm install -g nodemon

# Удалить пакет
npm uninstall axios

После установки пакета в вашей папке появится:

▶️ npm scripts — команды проекта

Раздел scripts в package.json — это мощный инструмент. Здесь вы определяете команды, которые можно запустить через npm run. Это удобно: вместо того чтобы помнить длинную команду с кучей флагов, вы просто пишете npm run build.

{
  "scripts": {
    "start": "node index.js",
    "dev": "node --watch index.js",
    "build": "webpack --mode production --config webpack.config.js",
    "test": "jest --coverage",
    "lint": "eslint src/**/*.js",
    "format": "prettier --write src/"
  }
}

# Запустить скрипты:
npm start           # npm run start можно сократить до npm start
npm run dev
npm run build
npm test            # npm run test можно сократить до npm test
npm run lint

⭐ Популярные пакеты — с чего начать

Вот несколько пакетов, с которыми вы точно столкнётесь в реальной разработке:

import axios from 'axios';

const response = await axios.get('https://api.example.com/users');
console.log(response.data); // Уже разобранный JSON

import { format, addDays, differenceInDays } from 'date-fns';
import { ru } from 'date-fns/locale';

const today = new Date();
console.log(format(today, 'dd MMMM yyyy', { locale: ru })); // 24 июня 2026
console.log(addDays(today, 7)); // дата через 7 дней

import _ from 'lodash';

const users = [
  { name: 'Алиса', age: 25 },
  { name: 'Боб', age: 30 },
  { name: 'Алиса', age: 22 }
];

const grouped = _.groupBy(users, 'name');
// { 'Алиса': [{...}, {...}], 'Боб': [{...}] }

const sorted = _.sortBy(users, 'age');
const unique = _.uniqBy(users, 'name');

🔢 Семантическое версионирование (SemVer)

Версии пакетов в npm следуют стандарту SemVer (Semantic Versioning): три числа через точку — MAJOR.MINOR.PATCH.

В package.json символы перед версией имеют значение:

{
  "dependencies": {
    "axios": "^1.6.0",    // ^ — принимать MINOR и PATCH обновления (1.x.x)
    "lodash": "~4.17.21", // ~ — принимать только PATCH обновления (4.17.x)
    "date-fns": "3.0.0"   // без символа — строго эта версия
  }
}

⚖️ npm vs yarn vs pnpm

Кроме npm существуют альтернативные менеджеры пакетов. Вы можете столкнуться с ними в разных проектах — важно понимать разницу.

✅ Итоги урока

• npm — крупнейший реестр пакетов для JavaScript, устанавливается вместе с Node.js
• package.json — манифест проекта: название, версия, зависимости, скрипты
• npm init -y создаёт package.json, npm install axios устанавливает пакет
• dependencies — для работы; devDependencies (флаг -D) — только для разработки
• node_modules/ нельзя коммитить в Git — добавьте в .gitignore
• Скрипты в scripts запускаются через npm run имя или npm start / npm test
• Версионирование: MAJOR.MINOR.PATCH — ^ разрешает minor/patch, ~ только patch
• Альтернативы: yarn и pnpm — быстрее, но npm подходит для начала