Jak zainstalować i używać npm w Ubuntu: Kompletny przewodnik dla początkujących (2025)

1. Wstęp

Dlaczego używać npm na Ubuntu?

Jednym z niezbędnych narzędzi zarówno do rozwoju frontendu, jak i backendu jest npm (Node Package Manager). Szeroko stosowany jako domyślny menedżer pakietów dla Node.js, npm ułatwia instalację i zarządzanie bibliotekami oraz narzędziami JavaScript.

Używanie npm na Ubuntu wykorzystuje szybkość Linuksa i elastyczne zarządzanie pakietami, znacząco poprawiając efektywność rozwoju. Ubuntu jest popularną dystrybucją wśród programistów, używaną do wszystkiego, od operacji serwerowych po lokalne środowiska deweloperskie.

Podczas pracy z frameworkami opartymi na Node.js, takimi jak Vue.js, React czy Next.js, powszechnie używa się npm do zarządzania pakietami. Konfiguracja tych narzędzi na Ubuntu zapewnia bardziej stabilne środowisko deweloperskie z mniejszą liczbą problemów w porównaniu do Windowsa lub macOS.

Cel tego artykułu

Ten artykuł poprowadzi Cię przez instalację npm na Ubuntu i opanowanie jego podstawowego użycia. Jest szczególnie pomocny dla następujących czytelników:

• Deweloperów nowych w Ubuntu
• Wszystkich, którzy mają problemy z konfiguracją Node.js i npm
• Osób, które chcą nauczyć się użycia npm w strukturalny sposób

Omówimy wiele metod instalacji, dyskutując o zaletach i wadach każdej z nich. Zajmiemy się również powszechnymi błędami, wskazówkami do rozwiązywania problemów oraz zbiorem przydatnych poleceń, które pomogą Ci szybko uruchomić npm na Ubuntu.

2. Jak zainstalować Node.js i npm na Ubuntu

Aby używać npm na Ubuntu, najpierw musisz zainstalować Node.js. Dzieje się tak, ponieważ npm jest dołączony do Node.js, więc instalacja Node.js automatycznie czyni npm dostępnym.

W tej sekcji omówimy trzy główne metody instalacji Node.js i npm na Ubuntu. Każda metoda ma swoje cechy, więc ważne jest, aby wybrać tę, która pasuje do Twojego stylu i celów deweloperskich.

Metoda 1: Używając oficjalnego repozytorium Ubuntu

Kroki

Node.js jest dostępny w domyślnych repozytoriach Ubuntu. Ta metoda jest najłatwiejsza i najbardziej przyjazna dla początkujących.

sudo apt update
sudo apt install nodejs npm

Po instalacji możesz sprawdzić zainstalowane wersje za pomocą następujących poleceń:

node -v
npm -v

Zalety

• Proste polecenia, łatwe do wykonania
• Bezpieczna i stabilna wersja

Wady

• Wersja Node.js/npm może być nieaktualna, więc niektóre nowsze funkcje mogą nie być dostępne

Metoda 2: Używając NodeSource PPA

Możesz uzyskać nowsze wersje Node.js i npm, używając repozytorium NodeSource, które jest ściśle powiązane z oficjalnym wsparciem Node.js.

Kroki (Przykład: Instalacja Node.js 18.x)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

npm zostanie zainstalowany automatycznie wraz z Node.js.

Zalety

• Dostęp do nowszych, ale stabilnych wersji
• Łatwa instalacja i dobrze działa z Ubuntu

Wady

• Jak w przypadku każdego PPA, może wymagać ręcznego zarządzania zależnościami systemowymi

Metoda 3: Używając nvm (Node Version Manager)

Jeśli chcesz przełączać się między wieloma wersjami Node.js, używanie nvm jest najbardziej elastyczną i wygodną metodą.

Kroki

Najpierw zainstaluj nvm:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Następnie przeładuj powłokę i zainstaluj Node.js za pomocą nvm:

source ~/.bashrc  # or ~/.zshrc
nvm install 18
nvm use 18

npm zostanie również zainstalowany automatycznie z Node.js.

Zalety

• Łatwe przełączanie między różnymi wersjami Node.js
• Ustawianie wersji na projekt dla lepszej kompatybilności
• Nie wpływa na środowisko systemowe, bezpieczne w użyciu

Wady

• Trochę bardziej skomplikowana konfiguracja w porównaniu do innych metod
• Musisz zmodyfikować plik konfiguracyjny powłoki

Którą metodę powinieneś wybrać?

Jeśli planujesz używać npm na Ubuntu do długoterminowego rozwoju, nvm jest najbardziej polecaną metodą. Jednak jeśli chcesz szybko zacząć, NodeSource PPA jest również solidnym wyborem.

3. Podstawowe użycie npm

Po skonfigurowaniu Node.js i npm w systemie Ubuntu następnym krokiem jest rozpoczęcie zarządzania pakietami przy użyciu npm. npm jest potężnym narzędziem służącym do instalacji, aktualizacji i usuwania pakietów JavaScript.

W tej sekcji przedstawimy najczęściej używane polecenia npm, które pomogą Ci rozpocząć pracę.

Instalowanie pakietów

Instalacja lokalna

Pakiety używane wyłącznie w konkretnym projekcie powinny być instalowane lokalnie. Jest to standardowe podejście i instalacja pakietu odbywa się w katalogu node_modules, a szczegóły są zapisywane w pliku package.json.

npm install package-name

Przykład: instalacja axios

npm install axios

Tylko skrypty w tym samym projekcie będą mogły korzystać z tego pakietu.

Instalacja globalna

Narzędzia używane w całym systemie, takie jak aplikacje CLI, powinny być instalowane globalnie.

npm install -g package-name

Przykład: instalacja http-server globalnie

sudo npm install -g http-server

W Ubuntu może być konieczne użycie sudo przy opcji -g.

Odinstalowywanie pakietów

Jeśli pakiet nie jest już potrzebny, możesz go usunąć, używając poniższych poleceń.

Usunięcie pakietu lokalnego

npm uninstall package-name

Usunięcie pakietu globalnego

sudo npm uninstall -g package-name

Aktualizacja pakietów

Aby zaktualizować pakiety do najnowszej wersji, możesz użyć następujących poleceń.

Aktualizacja konkretnego pakietu

npm update package-name

Aktualizacja wszystkich zależności jednocześnie

npm update

Zauważ, że aktualizuje to pakiety tylko w zakresie wersji określonym w package.json, więc zawsze sprawdzaj numery wersji.

Instalowanie pakietów deweloperskich (–save-dev)

Pakiety używane wyłącznie w środowiskach deweloperskich — takich jak testy czy narzędzia budujące — powinny być instalowane z opcją --save-dev.

npm install --save-dev package-name

Przykład: instalacja jest jako zależności deweloperskiej

npm install --save-dev jest

Spowoduje to dodanie pakietu do sekcji devDependencies w Twoim pliku package.json.

Wyświetlanie zainstalowanych pakietów

Lista pakietów lokalnych

npm list

Lista pakietów globalnych

npm list -g --depth=0

Podając --depth=0, wyświetlane są tylko pakiety najwyższego poziomu, co ułatwia odczyt listy.

Zarządzanie zależnościami projektu przy użyciu package.json

Plik package.json, znajdujący się w katalogu głównym projektu, odgrywa kluczową rolę w przepływie pracy npm. Przechowuje nazwy pakietów, ich wersje oraz niestandardowe skrypty, będąc jednocześnie plikiem konfiguracyjnym projektu.

Możesz utworzyć plik package.json, używając następującego polecenia:

npm init

Uruchamia to interaktywną konfigurację. Jeśli wolisz pominąć pytania i użyć wartości domyślnych:

npm init -y

Spowoduje to automatyczne wygenerowanie pliku package.json z ustawieniami domyślnymi.

4. Typowe problemy i ich rozwiązania

Podczas korzystania z npm w Ubuntu możesz napotkać błędy lub nieoczekiwane zachowania. W tej sekcji omówiono najczęstsze problemy — szczególnie te, z którymi borykają się początkujący — oraz sposoby ich rozwiązania.

Błędy uprawnień

Objawy

EACCES: permission denied

Ten błąd pojawia się najczęściej przy próbie globalnej instalacji npm.

Przyczyna

Dzieje się tak, gdy bieżący użytkownik nie ma uprawnień zapisu do katalogu, w którym npm próbuje instalować pakiety. W Ubuntu, ze względów bezpieczeństwa, systemowe katalogi takie jak /usr/lib/node_modules wymagają użycia sudo do modyfikacji.

Rozwiązania

• Uruchom polecenie instalacji z sudo :

  sudo npm install -g package-name
  

• Albo zmień globalny katalog instalacji na katalog użytkownika, aby uniknąć używania sudo :

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  

Następnie dodaj poniższe do swojego pliku ~/.bashrc lub ~/.profile, aby zaktualizować PATH:

export PATH="$HOME/.npm-global/bin:$PATH"

Aby zastosować zmiany, uruchom ponownie terminal lub wykonaj:

source ~/.bashrc

npm Command Not Found

Symptoms

command not found: npm

Nawet po instalacji terminal może nie rozpoznawać polecenia npm.

Causes

• Node.js i npm nie zostały poprawnie zainstalowane
• Lokalizacja pliku binarnego nie jest uwzględniona w zmiennej PATH

Solutions

Najpierw sprawdź, czy binarka npm jest dostępna:

which npm

Jeśli nic nie zostanie zwrócone, ponownie zainstaluj npm lub sprawdź, czy zmienne środowiskowe są poprawnie ustawione. Jeśli używasz nvm, upewnij się, że w pliku konfiguracyjnym powłoki (np. .bashrc lub .zshrc) znajduje się kod inicjalizujący nvm:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Package Won’t Install / Version Conflict

Symptoms

• Instalacja pakietu skutkuje błędami niezgodności wersji
• npm install wyświetla lawinę ostrzeżeń

Cause

npm wyświetla błędy lub ostrzeżenia, gdy zależności pakietów są ze sobą sprzeczne. Często zdarza się to w starszych projektach, w których wciąż wymienione są przestarzałe pakiety.

Solutions

• Spróbuj zainstalować najnowszą wersję:

  npm install package-name@latest
  

• Sprawdź drzewo zależności pakietu:

  npm ls package-name
  

• Wymuś instalację (niezalecane, chyba że jest to konieczne):

  npm install --legacy-peer-deps
  

• Wyczyść projekt i ponownie zainstaluj zależności:

  rm -rf node_modules package-lock.json
  npm install
  

Other Useful Debugging Tips

• npm doctor : Sprawdza konfigurację systemu i środowisko

  npm doctor
  

• npm audit : Skanuje pod kątem problemów bezpieczeństwa i sugeruje poprawki

  npm audit
  npm audit fix
  

Większość błędów npm w Ubuntu wyświetlana jest po angielsku, co na początku może przytłaczać. Jednak czytając komunikaty uważnie i postępując krok po kroku, zazwyczaj można szybko rozwiązać problem.

5. Frequently Asked Questions (FAQ)

W tej sekcji znajdują się odpowiedzi na najczęstsze pytania nowych użytkowników Ubuntu + npm. Skorzystaj z nich, aby zapobiec problemom i stworzyć płynniejsze środowisko programistyczne.

Q1. How can I update npm to the latest version on Ubuntu?

A1.

Możesz zaktualizować npm do najnowszej wersji, używając następującego polecenia:

sudo npm install -g npm@latest

Jeśli używasz nvm, nie potrzebujesz sudo:

npm install -g npm@latest

Aby sprawdzić zainstalowaną wersję:

npm -v

Q2. What’s the difference between global and local npm installations?

A2.

• Instalacja lokalna:
• Służy do zarządzania zależnościami w konkretnym projekcie
• Pakiety instalowane są w katalogu node_modules
• Łatwo udostępnić je współpracownikom poprzez package.json
• Instalacja globalna:
• Służy do narzędzi, które chcesz mieć dostępne systemowo (np. narzędzia CLI)
• Pakiety zazwyczaj instalowane są w /usr/lib/node_modules w Ubuntu
• Może wymagać sudo przy instalacji

Q3. What are the benefits of using nvm?

A3.

nvm (Node Version Manager) pozwala łatwo przełączać się między wieloma wersjami Node.js. Oto korzyści:

• Idealny do zarządzania różnymi wersjami dla różnych projektów
• Nie wpływa na ustawienia systemowe, co czyni go bezpieczniejszym
• npm jest również zarządzany per wersja Node, co zapewnia elastyczne środowisko

Q4. What should I do if npm dependencies get messed up?

A4.

Najpierw usuń node_modules i package-lock.json, a następnie ponownie zainstaluj wszystko:

rm -rf node_modules package-lock.json
npm install

Jeśli to nie pomoże, spróbuj użyć polecenia npm ci dla czystej reinstalacji (zalecane w pipeline’ach CI/CD).

Q5. Is it okay if I see “WARN” or “audit” in npm output?

A5.

Ostrzeżenia (WARN) nie są krytyczne, ale sygnalizują potencjalne problemy, takie jak przestarzałe zależności lub przestarzałe funkcje.

W przypadku ostrzeżeń związanych z bezpieczeństwem możesz spróbować naprawić je automatycznie, używając:

npm audit fix

Ideally, review the changes and commit them with Git to maintain a safe and stable codebase.

P6. Jakie rodzaje projektów mogę tworzyć przy użyciu npm w Ubuntu?

O6.

npm jest twoją bramą do ekosystemu JavaScript. Oto kilka rzeczy, które możesz zbudować w Ubuntu:

• Aplikacje frontendowe wykorzystujące frameworki takie jak React, Vue lub Svelte
• Generatory statycznych stron takie jak Next.js lub Nuxt
• API backendowe przy użyciu Express lub NestJS
• Niestandardowe narzędzia CLI
• Środowiska testowe z Jest lub Mocha

Korzystając z npm w Ubuntu, możesz wykorzystać pełną moc ekosystemu open‑source do tworzenia wydajnych, skalowalnych i nowoczesnych aplikacji.

6. Podsumowanie: Opanowanie npm w Ubuntu

W tym artykule omówiliśmy wszystko, co musisz wiedzieć, aby zainstalować i skutecznie używać npm w Ubuntu. Od metod instalacji po podstawowe polecenia, oto szybkie podsumowanie najważniejszych punktów.

Najważniejsze wnioski

• Czym jest npm? – Menedżer pakietów dołączony do Node.js, który znacząco zwiększa produktywność programistyczną
• Jak zainstalować npm w Ubuntu: – Możesz go zainstalować z oficjalnego repozytorium, NodeSource PPA lub przy użyciu nvm, w zależności od potrzeb
• Podstawowe funkcje: – Proste polecenia do instalacji, usuwania, aktualizacji i zarządzania zależnościami
• Rozwiązywanie problemów: – Wskazówki dotyczące rozwiązywania błędów uprawnień, konfliktów wersji i innych
• Sekcja FAQ: – Jasne odpowiedzi na typowe pytania pojawiające się w rzeczywistym rozwoju

Notatka dla początkujących

Ubuntu i npm to świetna para do nowoczesnego rozwoju webowego. Choć na początku możesz napotkać błędy lub niejasności, radzenie sobie z nimi pogłębi twoją wiedzę i pomoże ci rozwijać się jako programista.

Najważniejsze jest praktyczne wypróbowywanie. Uruchamianie każdego polecenia, czytanie wyników i uczenie się na błędach szybko zwiększy twoją pewność siebie.

To już koniec naszego przewodnika po używaniu npm w Ubuntu. Mamy nadzieję, że pomoże ci zbudować solidne środowisko programistyczne i przyspieszyć twoją drogę rozwoju umiejętności.

Będziemy dalej udostępniać więcej wskazówek dotyczących Linuksa oraz tutoriali frontendu, więc nie wahaj się dodać tej strony do zakładek lub udostępnić ją w mediach społecznościowych!