Установка пакетов через npm: быстро и без ошибок
Установить через npm можно одной командой: в проект — npm install <пакет>, для инструментов разработки — npm install -D <пакет>, глобально для CLI — npm install -g <пакет>. Ниже — когда что выбирать и какие команды реально нужны в работе.
Установка пакета в проект (обычная зависимость)
Используйте, когда библиотека нужна в коде приложения (например, для работы с датами, запросами, утилитами):
npm install <имя-пакета>
Пример:
npm install lodash
Результат: npm скачает пакет в node_modules и добавит его в package.json в секцию dependencies.
Если вы ставите пакет впервые в новом проекте, сначала создайте package.json командой npm init -y, чтобы зависимости фиксировались корректно.
Установка как dev-зависимость (для разработки)
Подходит для линтеров, тестов, сборщиков, форматтеров — всего, что нужно для разработки, но не обязательно для запуска в продакшене:
npm install -D <имя-пакета>
Пример:
npm install -D eslint
Пакет попадёт в devDependencies.
Частая ошибка: поставить сборщик/тесты в dependencies и тянуть лишнее в прод. Если инструмент нужен только разработчикам и CI — используйте -D.
Глобальная установка (если нужна команда в терминале)
Глобальная установка нужна, когда пакет предоставляет CLI-команду, которую вы запускаете из любой папки:
npm install -g <имя-пакета>
Пример:
npm install -g nodemon
Проверить, что команда доступна:
nodemon -v
Во многих случаях глобальная установка не обязательна: CLI можно запускать локально через npx <команда> или через npm-скрипты в package.json.
Установка зависимостей из package.json (после клона проекта)
Если вы скачали проект, где уже есть package.json, просто установите всё одной командой:
npm install
npm поставит версии, зафиксированные в package-lock.json (если он есть), что помогает избежать расхождений между окружениями.
Полезные команды: версия, обновление и удаление
Установить конкретную версию
npm install <пакет>@<версия>
Пример:
npm install react@18.2.0
Обновить пакет
npm update <пакет>
Удалить пакет
Обычная зависимость:
npm uninstall <пакет>
Dev-зависимость (обычно достаточно той же команды — npm сам уберёт запись, если она была dev):
npm uninstall <пакет>
Если npm не устанавливает: что проверить быстро
- Вы в нужной папке проекта (там, где
package.json). - Нет ли ошибок прав доступа при
-g(часто на macOS/Linux). - Попробуйте очистить кэш, если установки странно падают:
npm cache clean --force
- Проверьте версии:
node -v
npm -v
Если скажете, какой пакет ставите и куда (в проект, dev или глобально), можно подобрать точную команду и тип установки.