Jak włączyć i używać npm (Node.js Package Manager) w ServBay

npm (Node Package Manager) to oficjalne narzędzie do zarządzania pakietami dla Node.js i jeden z największych na świecie ekosystemów open source. Dla programistów Node.js npm to narzędzie niezbędne, które umożliwia łatwą instalację, współdzielenie i zarządzanie zależnościami projektowymi. Dzięki zintegrowanemu środowisku ServBay możesz bardzo szybko rozpocząć pracę z npm.

Wymagania wstępne

Przed użyciem npm musisz mieć zainstalowany Node.js w ServBay.

1. Otwórz aplikację ServBay.
2. Przejdź do panelu „Pakiety” (Packages).
3. Znajdź pakiet Node.js i upewnij się, że jest zainstalowany oraz uruchomiony.

ServBay automatycznie skonfiguruje środowisko Node.js wraz z npm.

Sprawdzanie, czy npm jest zainstalowane i dostępne

Node.js zainstalowany przez ServBay zawiera już w sobie npm, które jest domyślnie aktywowane. Możesz szybko sprawdzić w terminalu, czy npm zostało poprawnie zainstalowane i jest dostępne.

1. Otwórz swoją aplikację terminalową (np. Terminal w macOS).

2. Wpisz poniższe polecenie, aby sprawdzić wersję npm:

   npm -v

   Jeśli polecenie wykona się poprawnie i wyświetli numer wersji (np. 10.2.0 lub nowszą), oznacza to, że npm działa i jest gotowe do użytku w obecnym środowisku.

   # Przykładowy wynik
   10.2.0

   Jeśli zobaczysz błąd typu „command not found: npm”, upewnij się, że zainstalowałeś pakiet Node.js przez ServBay oraz że zmienne środowiskowe ServBay są poprawnie załadowane (zwykle wystarczy ponowne uruchomienie terminala lub komputera, aby rozwiązać ten problem).

Aktualizacja npm

Chociaż Node.js zainstalowany przez ServBay zazwyczaj zawiera stabilną wersję npm, samo npm jest aktualizowane niezależnie i dość często. Aby korzystać z najnowszych funkcji i poprawek, możesz zaktualizować npm poleceniem:

npm install -g npm@latest

To polecenie zainstaluje najnowszą wersję npm globalnie. Flaga -g oznacza instalację globalną, dzięki czemu komenda npm w nowej wersji będzie dostępna wszędzie.

Po zakończeniu aktualizacji ponownie sprawdź wersję poleceniem npm -v:

npm -v

Kluczowe funkcje npm i typowe zastosowania

Siła npm tkwi w jego rozległym ekosystemie open source i wygodnym mechanizmie zarządzania zależnościami. Oto kilka najważniejszych scenariuszy i poleceń używanych podczas codziennej pracy z npm:

Inicjowanie nowego projektu Node.js

Aby rozpocząć nowy projekt Node.js w pustym katalogu, możesz użyć polecenia npm init, by utworzyć plik package.json. Ten plik stanowi rdzeń projektu – przechowuje jego metadane, listę zależności oraz dostępne skrypty.

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

Polecenie npm init przeprowadzi Cię przez proces wpisywania nazwy projektu, wersji, opisu, pliku wejściowego itd. Możesz także użyć npm init -y, by automatycznie wygenerować domyślny plik package.json.

Instalowanie zależności projektu

W katalogu głównym projektu (tam, gdzie znajduje się plik package.json) możesz zainstalować wszystkie wymagane zależności poleceniem npm install.

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

Polecenie to odczyta sekcje dependencies i devDependencies z pliku package.json i pobierze odpowiednie moduły do folderu node_modules w projekcie.

Dodawanie nowych pakietów

Jeśli musisz dodać do projektu nową bibliotekę lub framework, użyj polecenia npm install <nazwa-pakietu>.

# Instalacja zależności produkcyjnej, np. frameworka Express
npm install express

# Instalacja zależności deweloperskiej, np. narzędzia do testowania Mocha
npm install mocha --save-dev

Domyślnie, npm install <nazwa-pakietu> instaluje paczkę do katalogu node_modules projektu i automatycznie aktualizuje sekcję dependencies w package.json. Flaga --save-dev umieszcza pakiet w devDependencies – zalecane dla narzędzi developerskich, testowych czy do budowania projektu.

Usuwanie pakietów

Aby usunąć niepotrzebną już zależność, wykorzystaj polecenie npm uninstall <nazwa-pakietu>.

npm uninstall express

Pakiet zostanie skasowany z folderu node_modules, a zapis w package.json zostanie zaktualizowany.

Aktualizowanie zależności projektu

Aby upewnić się, że masz najnowsze dopuszczalne wersje zależności (zgodne z zakresami wersji w package.json), użyj polecenia npm update:

npm update

Polecenie sprawdzi zainstalowane już pakiety w node_modules oraz zaktualizuje je w obrębie zdefiniowanych przedziałów wersji.

Korzystanie ze skryptów npm (Scripts)

Pole scripts w pliku package.json umożliwia definiowanie własnych poleceń wykonywanych przez wiersz poleceń. To prosty sposób na automatyzację powtarzalnych zadań – takich jak uruchamianie serwera, testowanie czy budowanie projektu.

Przykładowy fragment package.json ze zdefiniowanymi skryptami:

{
  "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"
  }
}

Skrypty te uruchomisz poleceniem npm run <nazwa-skryptu> w terminalu:

# Uruchomienie aplikacji
npm start

# Wykonanie testów
npm test

# Zbudowanie projektu
npm run build

Uwaga: dla kilku specjalnych nazw skryptów, takich jak start, test, install, restart, stop, możesz pominąć słowo run i wywołać je bezpośrednio, np. npm start, npm test.

Szybka ściągawka najczęstszych poleceń npm

Oprócz podstawowego zastosowania, przydatne są również następujące polecenia:

• Instalacja globalna pakietów – przeznaczone do narzędzi, które mają być dostępne z dowolnego miejsca w systemie.

  npm install -g <nazwa-pakietu>
  # Przykładowo, instalacja npx do uruchamiania tymczasowych poleceń (często już w komplecie z Node.js)
  npm install -g npx
  # Instalacja narzędzia nodemon do automatycznego restartowania aplikacji w trybie deweloperskim
  npm install -g nodemon

• Wykonywanie tymczasowych komend (npx) – npx to narzędzie dołączone do npm od wersji 5.2+, pozwala uruchamiać pliki wykonywalne z katalogu node_modules/.bin lub pobierać i uruchamiać polecenia jednorazowo bez instalacji globalnej.

  # Utwórz nową aplikację React bez globalnej instalacji create-react-app
  npx create-react-app my-react-app

• Wyświetlanie globalnie zainstalowanych pakietów – pozwala zobaczyć wersje wszystkich globalnie dostępnych paczek.

  npm list -g --depth=0

• Czyszczenie cache npm – jeśli wystąpią błędy instalacji, warto spróbować wyczyścić cache.

  npm cache clean --force

• Wyświetlanie informacji o pakiecie – szczegóły dotyczące wersji, zależności, repozytorium itp.

  npm view <nazwa-pakietu>

• Wyszukiwanie paczek – przeszukiwanie rejestru npm według słów kluczowych.

  npm search <słowo-kluczowe>

Rozwiązywanie problemów

• npm command not found: Upewnij się, że masz zainstalowany pakiet Node.js przez ServBay i bieżąca sesja terminala widzi ścieżki instalacji Node.js oraz npm. Zazwyczaj wystarczy ponowne uruchomienie terminala lub komputera.
• Nieudana instalacja zależności: Sprawdź połączenie z internetem. Czasami korporacyjne proxy może mieć wpływ na instalację – rozważ konfigurację proxy w ustawieniach npm. Warto także spróbować ponownie po czyszczeniu cache (npm cache clean --force).
• Problemy z uprawnieniami: Na macOS przy instalacjach globalnych (npm install -g) mogą pojawiać się problemy z uprawnieniami. Zalecamy użycie Node Version Manager (nvm) lub upewnienie się, że ServBay prawidłowo skonfigurował ścieżkę instalacji Node.js. Nie używaj sudo do instalacji paczek globalnych, bo może to prowadzić do trudnych do rozwiązania problemów. Instalacja Node.js przez ServBay zwykle rozwiązuje kwestie uprawnień – możesz bezpiecznie pracować w obrębie katalogu ServBay.

Podsumowanie

Z ServBay bardzo łatwo skonfigurujesz na lokalnym komputerze w pełni funkcjonalne środowisko Node.js i natychmiast zaczniesz korzystać z potężnych możliwości npm do zarządzania paczkami i pracą nad projektami. Opanowanie podstawowych komend oraz nawyków związanych z użyciem npm znacząco usprawni Twoją codzienną pracę. Im głębiej poznasz ekosystem Node.js, tym bardziej docenisz, że npm stanie się Twoim nieodłącznym narzędziem.