Як увімкнути та використовувати npm (менеджер пакунків Node.js) у ServBay

npm (Node Package Manager) — офіційний менеджер пакунків Node.js і один із найбільших open-source репозиторіїв у світі. Для розробників Node.js це незамінний інструмент, який дозволяє легко інсталювати, обмінюватися й керувати залежностями проєктів. Завдяки інтегрованому середовищу ServBay ви можете швидко розпочати розробку з npm.

Передумови

Перш ніж використовувати npm, вам потрібно встановити Node.js через ServBay.

Відкрийте застосунок ServBay.
Перейдіть на панель «Пакунки» (Packages).
Знайдіть пакунок Node.js і переконайтеся, що він встановлений і запущений.

ServBay автоматично налаштовує середовище Node.js, включаючи npm.

Перевірка встановлення та доступності npm

Node.js, встановлений через ServBay, уже містить npm і стандартно активований. Ви можете швидко перевірити доступність npm у терміналі.

Відкрийте свій термінал (наприклад, Terminal у macOS).
Введіть команду, щоб переглянути версію npm:
bash
```
npm -v
```
1
Якщо команда виконується успішно та показує номер версії (наприклад, 10.2.0 або новішу), npm встановлений і доступний для використання.
bash
```
# Приклад виводу
10.2.0
```
1
2
Якщо бачите помилку на кшталт «command not found: npm», переконайтесь, що Node.js встановлено через ServBay і змінні середовища правильно завантажені (зазвичай допомагає перезапуск терміналу або комп’ютера).

Оновлення npm

Хоча Node.js, інстальований із ServBay, зазвичай містить стабільну версію npm, сам npm розвивається незалежно і часто оновлюється. Щоб отримати останні можливості та виправлення, можна оновити npm так:

bash

npm install -g npm@latest

Ця команда встановить найновішу версію npm глобально. Прапорець -g означає встановлення для всієї системи, тож нова версія буде доступна всюди.

Після оновлення перевірте версію ще раз:

bash

npm -v

Основні можливості та часті сценарії використання npm

npm потужний завдяки розвиненій open-source екосистемі і зручному керуванню залежностями. Ось кілька частих сценаріїв та команд для щоденної роботи:

Ініціалізація нового Node.js-проєкту

Щоб розпочати новий Node.js-проєкт у порожній теці, створіть файл package.json командою npm init. Цей файл — ядро вашого проєкту: у ньому зберігаються метадані, інформація про залежності та скрипти.

bash

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

npm init допоможе вам заповнити назву, версію, опис, файл входу тощо. Для швидкого створення з типовими налаштуваннями можна використати npm init -y.

Встановлення залежностей проєкту

У кореневій теці проєкту (де зберігається package.json) використовуйте команду npm install для завантаження всіх необхідних залежностей.

bash

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

Команда зчитує поля dependencies і devDependencies із файлу package.json та завантажує відповідні модулі в теку node_modules.

Додавання нових залежностей

Якщо потрібно підключити нову бібліотеку чи фреймворк, використайте команду npm install <package-name>.

bash

# Встановити основну залежність, наприклад, фреймворк Express
npm install express

# Встановити залежність для розробки (наприклад, Mocha для тестування)
npm install mocha --save-dev

За замовчуванням, npm install <package-name> додає пакет у теку node_modules і поле dependencies у package.json. Прапорець --save-dev заносить пакет до devDependencies, що актуально для інструментів розробки, тестування чи збірки.

Видалення залежностей

Якщо залежність більше не потрібна у проєкті, видаліть її так:

bash

npm uninstall express

Це видалить пакет із теки node_modules і оновить ваш package.json.

Оновлення залежностей проєкту

Щоб оновити всі залежності у межах зазначених у package.json версій, скористайтесь npm update.

bash

npm update

Команда перевіряє встановлені модулі й оновлює їх до найновіших сумісних версій відповідно до файлу package.json.

Використання npm-скриптів (Scripts)

Поле scripts у файлі package.json дозволяє створювати власні команди для автоматизації повторюваних задач, таких як запуск локального сервера, тестів або збірки проєкту.

Наприклад, у вашому package.json можуть бути скрипти:

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 run <script-name> для запуску цих команд у терміналі:

bash

# Запустити застосунок
npm start

# Виконати тести
npm test

# Зібрати проєкт
npm run build

Зверніть увагу: для певних скриптів (start, test, install, restart, stop) можна опускати run і писати просто npm start чи npm test.

Швидкий довідник частих команд npm

Окрім основних сценаріїв, є й інші корисні команди:

Встановлення глобальних пакунків: Додає інструменти, доступні в будь-якому місці вашої системи.

bash

npm install -g <package-name>
# Наприклад, встановити npx (зазвичай йде з Node.js)
npm install -g npx
# Або популярний інструмент nodemon для автоперезапуску застосунка
npm install -g nodemon

Виконання тимчасових команд (npx): npx — інструмент із npm 5.2+ для запуску виконуваних файлів із node_modules/.bin або миттєвого завантаження й запуску пакетів без глобальної інсталяції.
bash
```
# Створити новий React-додаток без глобальної інсталяції create-react-app
npx create-react-app my-react-app
```
1
2
Перегляд глобальних пакунків: Показує встановлені глобально пакети й їхні версії.
bash
```
npm list -g --depth=0
```
1
Очищення кешу npm: Якщо виникають помилки при встановленні, іноді допомагає очищення кешу.
bash
```
npm cache clean --force
```
1
Перегляд інформації про пакунок: Детальна інформація про версію, залежності, репозиторій тощо.
bash
```
npm view <package-name>
```
1
Пошук пакунків: Шукає потрібний пакет у репозиторії npm.
bash
```
npm search <keyword>
```
1

Усунення неполадок

npm command not found: Переконайтеся, що ви встановили Node.js через ServBay, а середовище терміналу «бачить» папку з Node.js і npm. Зазвичай допомагає закрити й відкрити термінал або перезавантажити комп’ютер.
Збій встановлення залежностей: Перевірте інтернет-з’єднання. Корпоративні проксі-сервери можуть блокувати npm — тоді потрібно налаштувати проксі для npm. Також спробуйте очистити кеш npm (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.

Як увімкнути та використовувати npm (менеджер пакунків Node.js) у ServBay ​

Передумови ​

Перевірка встановлення та доступності npm ​

Оновлення npm ​

Основні можливості та часті сценарії використання npm ​

Ініціалізація нового Node.js-проєкту ​

Встановлення залежностей проєкту ​

Додавання нових залежностей ​

Видалення залежностей ​

Оновлення залежностей проєкту ​

Використання npm-скриптів (Scripts) ​

Швидкий довідник частих команд npm ​

Усунення неполадок ​

Висновок ​

Як увімкнути та використовувати npm (менеджер пакунків Node.js) у ServBay

Передумови

Перевірка встановлення та доступності npm

Оновлення npm

Основні можливості та часті сценарії використання npm

Ініціалізація нового Node.js-проєкту

Встановлення залежностей проєкту

Додавання нових залежностей

Видалення залежностей

Оновлення залежностей проєкту

Використання npm-скриптів (Scripts)

Швидкий довідник частих команд npm

Усунення неполадок

Висновок