Как включить и использовать npm (Node.js Package Manager) в ServBay

npm (Node Package Manager) — это официальный менеджер пакетов для Node.js и одно из крупнейших мировых хранилищ открытого программного обеспечения. Для разработчиков на Node.js это незаменимый инструмент: он позволяет легко устанавливать, делиться и управлять зависимостями в вашем проекте. Благодаря интегрированной среде ServBay вы можете быстро приступить к использованию npm при разработке.

Предварительные условия

Перед тем, как использовать npm, необходимо установить Node.js через ServBay.

1. Откройте приложение ServBay.
2. Перейдите на вкладку «Пакеты» (Packages).
3. Найдите пакет Node.js и убедитесь, что он установлен и запущен.

ServBay автоматически настраивает окружение Node.js, включая npm.

Проверка установки и доступности npm

Node.js, установленный через ServBay, уже содержит npm, который по умолчанию включён. Вы можете быстро убедиться в правильности установки и доступности npm через терминал.

1. Откройте ваше терминальное приложение (например, Terminal в macOS).

2. Введите следующую команду для проверки версии npm:

   npm -v

   Если команда выполнится успешно и отобразит версию (например, 10.2.0 или выше), значит, npm установлен правильно и доступен в вашей текущей среде.

   # Пример вывода
   10.2.0

   Если появится ошибка вроде «command not found: npm», проверьте, установлен ли через ServBay пакет Node.js, и правильно ли загружены переменные окружения ServBay (обычно помогает перезапуск терминала или компьютера).

Обновление npm

Хотя версия Node.js, устанавливаемая через ServBay, обычно включает стабильную версию npm, сам npm обновляется отдельно. Чтобы получить последние функции и исправления, вы можете обновить npm с помощью следующей команды:

npm install -g npm@latest

Эта команда установит самую свежую версию npm глобально. Флаг -g означает глобальную установку, чтобы вы могли использовать новую версию команды npm в любой директории.

После обновления вновь запустите проверку версии:

npm -v

Ключевые возможности и распространённые сценарии использования npm

npm ценен благодаря огромной экосистеме open-source-пакетов и удобному управлению зависимостями. Вот несколько типичных задач и часто используемых команд при разработке с использованием npm:

Инициализация нового проекта на Node.js

Чтобы начать новый проект Node.js в пустой директории, используйте команду npm init, которая создаст файл package.json — ядро любого проекта: там хранятся метаданные, сведения о зависимостях и доступных скриптах.

cd /Applications/ServBay/www/my-new-project.servbay.demo
npm init

npm init предложит вам поэтапно указать название, версию, описание проекта, входной файл и другие параметры. Для быстрого создания файла с настройками по умолчанию используйте npm init -y.

Установка зависимостей проекта

В корне проекта (где располагается файл package.json) используйте команду npm install, чтобы установить все зависимости, необходимые для проекта.

cd /Applications/ServBay/www/my-project.servbay.demo
npm install

Эта команда прочитает поля dependencies и devDependencies в package.json и загрузит все указанные модули в директорию node_modules.

Добавление новых зависимостей

Чтобы подключить библиотеку или фреймворк, требуется команда npm install <package-name>:

# Установка рабочей зависимости, например, фреймворка Express
npm install express

# Установка зависимости только для разработки, например, фреймворка для тестирования Mocha
npm install mocha --save-dev

По умолчанию, npm install <package-name> добавляет пакет в папку node_modules и автоматически обновляет раздел dependencies в package.json. Флаг --save-dev помещает пакет в devDependencies — для инструментов, используемых только в тестах, разработке или сборке.

Удаление зависимости

Если библиотека больше не нужна, удалите её через:

npm uninstall express

Пакет будет удалён из node_modules, а информация о нём исчезнет из package.json.

Обновление зависимостей проекта

Чтобы все зависимости были актуальны (в рамках версий, указанных в package.json), используйте команду:

npm update

Команда проверит установленные пакеты в node_modules и обновит их до последних совместимых версий согласно вашему package.json.

Использование npm-скриптов (Scripts)

В поле scripts файла package.json можно описывать свои команды для автоматизации рутинных задач: запуск сервера, тестирование, сборка и многое другое.

Например, так можно добавить секцию scripts в ваш package.json:

{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "start": "node index.js",
    "test": "mocha test/**/*.js",
    "build": "webpack --config webpack.config.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "mocha": "^10.2.0",
    "webpack": "^5.89.0"
  }
}

Теперь вы можете запускать эти скрипты через терминал так:

# Запуск приложения
npm start

# Запуск тестов
npm test

# Сборка проекта
npm run build

Обратите внимание, что для некоторых стандартных скриптов (start, test, install, restart, stop) можно опускать ключевое слово run и писать просто npm start, npm test и т.д.

Быстрая шпаргалка по часто используемым командам npm

Кроме рассмотренных выше, есть и другие востребованные команды для работы с npm:

• Установка глобальных пакетов: команды для инструментов, доступных из любой точки системы.

  npm install -g <package-name>
  # Например, установка npx для выполнения временных команд (чаще всего уже включён в Node.js)
  npm install -g npx
  # Или популярного CLI-инструмента nodemon для автоматического перезапуска приложений на этапе разработки
  npm install -g nodemon

• Выполнение временных команд (npx): npx (входит в npm версии 5.2 и выше) исполняет скрипты из node_modules/.bin или временно скачивает и запускает команду без глобальной установки пакета.

  # Создание нового React-проекта без установки create-react-app глобально
  npx create-react-app my-react-app

• Просмотр списка глобальных пакетов: вся установленные глобально пакеты и их версии.

  npm list -g --depth=0

• Очистка кеша npm: иногда проблемы с установкой связаны с кешированием — в таком случае рекомендуется очистить кеш.

  npm cache clean --force

• Просмотр информации о пакете: детальная справка по любому пакету — версии, зависимости, репозиторий и другое.

  npm view <package-name>

• Поиск пакетов: поиск библиотек по ключевым словам в реестре npm.

  npm search <keyword>

Устранение неполадок

• npm command not found: проверьте, установлен ли пакет Node.js через ServBay и настроен ли терминал на использование нужного пути. Обычно помогает перезапуск терминала или компьютера.
• Ошибка при установке зависимостей: проверьте, работает ли интернет-соединение, и нет ли корпоративного прокси, мешающего загрузке пакетов. Иногда помогает очистка кеша (npm cache clean --force) и повторная попытка.
• Проблемы с правами доступа: на macOS иногда возникают ошибки прав при глобальной установке (npm install -g). Рекомендуется использовать Node Version Manager (nvm) или убедиться, что ServBay корректно настроил пути для установки. Не стоит запускать глобальные установки через sudo — это чревато сложностями с доступом в будущем. Обычно Node.js, установленный ServBay, уже правильно настроен и позволяет устанавливать пакеты в своей директории.

Заключение

С помощью ServBay вы без труда получите полноценную локальную среду разработки Node.js и сможете сразу начать использовать мощный инструмент npm для управления пакетами и работы над проектом. Освоив базовые возможности и часто используемые команды npm, вы значительно повысите продуктивность. По мере погружения в Node.js-экосистему, npm станет вашим незаменимым помощником.