So verwenden Sie npm unter Ubuntu: Installation, Grundbefehle und Fehlerbehebungs‑Leitfaden

1. Einführung

Warum npm unter Ubuntu verwenden

Eines der wichtigsten Werkzeuge für Front‑ und Backend‑Entwicklung ist npm (Node Package Manager). npm wird als Paketverwaltungstool für Node.js breit eingesetzt und ermöglicht Entwicklern, JavaScript‑Bibliotheken und -Tools einfach zu installieren und zu verwalten.

Durch die Nutzung von npm unter Ubuntu können Sie die leichte Performance und die flexible Paketverwaltung von Linux ausnutzen und gleichzeitig die Entwicklungseffizienz deutlich steigern. Ubuntu ist eine Distribution, die von einer großen Entwickler‑Community unterstützt wird und sowohl für Server‑Operationen als auch für lokale Entwicklungsumgebungen weit verbreitet ist.

Insbesondere beim Arbeiten mit Node.js‑basierten Frameworks wie Vue.js, React und Next.js ist die Verwaltung von Paketen mit npm der Standardansatz. Diese Tools auf Ubuntu einzurichten, ermöglicht Ihnen eine stabile Entwicklungsumgebung mit weniger Problemen im Vergleich zu Windows oder macOS.

Ziel dieses Artikels

Dieser Artikel liefert eine Schritt‑für‑Schritt‑Anleitung zur Installation von npm unter Ubuntu und zur Beherrschung seiner Grundfunktionen. Er richtet sich vor allem an folgende Zielgruppen:

• Entwickler, die neu bei Ubuntu sind
• Personen, die Schwierigkeiten mit der Node.js‑ oder npm‑Einrichtung haben
• Jeder, der npm strukturiert erlernen möchte

Es werden mehrere Installationsmethoden vorgestellt, jeweils mit ihren Merkmalen, Vor- und Nachteilen. Zusätzlich behandelt dieser Leitfaden häufige Fehler, Fehlersuch‑Tipps und nützliche Befehle, um npm reibungslos unter Ubuntu zu nutzen.

2. Node.js und npm unter Ubuntu installieren

Um npm unter Ubuntu zu verwenden, müssen Sie zunächst Node.js installieren. Da npm zusammen mit Node.js ausgeliefert wird, steht npm nach der Node.js‑Installation automatisch zur Verfügung.

Im Folgenden werden drei gängige Methoden zur Installation von Node.js und npm unter Ubuntu beschrieben. Jede Methode hat ihre eigenen Eigenschaften, sodass Sie die für Ihren Entwicklungsstil und Zweck am besten geeignete auswählen sollten.

Methode 1: Das offizielle Ubuntu‑Repository verwenden

Schritte

Node.js ist in den Standard‑Repositories von Ubuntu enthalten. Dies ist der einfachste und anfängerfreundlichste Ansatz.

sudo apt update
sudo apt install nodejs npm

Nach der Installation können Sie die Versionen mit den folgenden Befehlen prüfen:

node -v
npm -v

Vorteile

• Einfache, leicht verständliche Befehle
• Stabile Versionen, die von Ubuntu bereitgestellt werden

Nachteile

• Die Node.js‑ und npm‑Versionen sind häufig veraltet, sodass die neuesten Features möglicherweise nicht verfügbar sind

Methode 2: Das NodeSource‑PPA verwenden

Durch die Nutzung des NodeSource‑Repositories, das eng am offiziellen Node.js‑Support ausgerichtet ist, können Sie neuere Versionen von Node.js und npm installieren.

Schritte (Beispiel: Installation von Node.js 18.x)

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

npm wird automatisch zusammen mit Node.js installiert.

Vorteile

• Zugriff auf relativ neue und stabile Versionen
• Einfache Installation mit guter Ubuntu‑Kompatibilität

Nachteile

• Wie bei anderen PPAs kann ein gewisser Aufwand für das Abhängigkeitsmanagement nötig sein

Methode 3: nvm (Node Version Manager) verwenden

Wenn Sie zwischen mehreren Node.js‑Versionen wechseln möchten, ist nvm die flexibelste und leistungsfähigste Option.

Schritte

Zuerst nvm installieren:

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

Dann die Shell neu laden und Node.js über nvm installieren:

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

npm wird automatisch zusammen mit Node.js installiert.

Vorteile

• Freier Wechsel zwischen Node.js‑Versionen
• Projektbezogene Versionsfestlegung möglich
• Sicher, da das System global nicht beeinflusst wird

Nachteile

• Etwas komplexere Einrichtung im Vergleich zu den anderen Methoden
• Erfordert das Bearbeiten von Shell‑Konfigurationsdateien

Welche Methode sollten Sie wählen?

Im Allgemeinen ist nvm die am meisten empfohlene Option für langfristige npm‑Entwicklung unter Ubuntu. Wenn Sie jedoch eine schnelle und einfache Einrichtung wünschen, ist die Verwendung des NodeSource‑PPA ebenfalls eine solide Wahl.

3. Grundlegende npm‑Verwendung

Sobald Node.js und npm unter Ubuntu installiert sind, können Sie mit npm Pakete verwalten. npm ist ein leistungsstarkes Werkzeug zum Installieren, Aktualisieren und Entfernen von JavaScript‑Paketen.

Dieser Abschnitt stellt häufig verwendete npm‑Befehle und Grundoperationen vor.

Pakete installieren

Lokale Installation

Pakete, die nur innerhalb eines bestimmten Projekts verwendet werden, sollten lokal installiert werden. Dies ist der Standardansatz. Pakete werden im Verzeichnis node_modules abgelegt und in package.json verzeichnet.

npm install package-name

Beispiel: Installation von axios

npm install axios

Nur Skripte innerhalb desselben Projekts können lokal installierte Pakete verwenden.

Globale Installation

Werkzeuge, die systemweit genutzt werden, wie CLI‑Utilities, sollten global installiert werden.

npm install -g package-name

Beispiel: Globale Installation von http-server

sudo npm install -g http-server

Unter Ubuntu kann die Verwendung von -g sudo erfordern.

Pakete deinstallieren

Lokale Pakete entfernen

npm uninstall package-name

Globale Pakete entfernen

sudo npm uninstall -g package-name

Pakete aktualisieren

Ein bestimmtes Paket aktualisieren

npm update package-name

Alle Abhängigkeiten aktualisieren

npm update

Updates werden innerhalb der in package.json angegebenen Versionsbereiche angewendet, achten Sie also auf Versionsbeschränkungen.

Entwicklungsabhängigkeiten installieren (–save-dev)

Entwicklungs‑Only‑Pakete wie Test‑ oder Build‑Tools sollten mit der Option --save-dev installiert werden.

npm install --save-dev package-name

Beispiel: Installation von jest als Entwicklungsabhängigkeit

npm install --save-dev jest

Damit wird das Paket unter devDependencies in package.json eingetragen.

Installierte Pakete auflisten

Lokale Pakete auflisten

npm list

Globale Pakete auflisten

npm list -g --depth=0

Mit --depth=0 werden nur Pakete der obersten Ebene angezeigt, wodurch die Ausgabe leichter lesbar wird.

Abhängigkeiten mit package.json verwalten

Die Datei package.json ist ein Kernbestandteil von npm‑basierten Projekten. Sie enthält Paketnamen, Versionen, Skripte und die gesamte Projektkonfiguration.

Sie können sie erstellen mit:

npm init

Für eine vereinfachte Einrichtung mit Standardwerten:

npm init -y

4. Häufige Probleme und Lösungen

Bei der Verwendung von npm unter Ubuntu können Fehler oder unerwartetes Verhalten auftreten. Dieser Abschnitt stellt gängige Probleme vor und zeigt, wie man sie behebt.

Berechtigungsfehler

Symptom

EACCES: permission denied

Ursache

Dies tritt auf, wenn der aktuelle Benutzer keine Schreibberechtigung für das Verzeichnis hat, in das npm Pakete installieren möchte. Unter Ubuntu erfordert das Schreiben in Systemverzeichnisse wie /usr/lib/node_modules sudo.

Lösung

• Ausführen mit sudo :

  sudo npm install -g package-name
  

• Oder das globale Installationsverzeichnis auf einen benutzereigenen Pfad ändern:

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

Fügen Sie Folgendes zu ~/.bashrc oder ~/.profile hinzu:

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

Änderungen übernehmen:

source ~/.bashrc

npm‑Befehl nicht gefunden

Symptom

command not found: npm

Ursache

• Node.js‑ oder npm‑Installation fehlgeschlagen
• PATH‑Umgebungsvariable ist nicht konfiguriert

Lösung

Pfad prüfen:

which npm

Wenn nichts zurückgegeben wird, neu installieren oder PATH‑Einstellungen überprüfen. Bei Verwendung von nvm sicherstellen, dass der Initialisierungscode in Ihrer Shell‑Konfigurationsdatei vorhanden ist:

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

Paketinstallationsfehler oder Versionskonflikte

Symptome

• Versionskonflikte beim Installieren eines Pakets
• Zahlreiche Warnungen während npm install

Lösungen

npm install package-name@latest

npm ls package-name

npm install --legacy-peer-deps

rm -rf node_modules package-lock.json
npm install

Nützliche Debugging-Befehle

• npm doctor

  npm doctor
  

• npm audit

  npm audit
  npm audit fix
  

5. Häufig gestellte Fragen (FAQ)

Q1. Wie kann ich npm auf die neueste Version auf Ubuntu aktualisieren?

A1.

sudo npm install -g npm@latest

Wenn Sie nvm verwenden, ist sudo nicht erforderlich.

Q2. Was ist der Unterschied zwischen globaler und lokaler Installation?

A2.

• Lokale Installation : Projektspezifische Abhängigkeiten, die in node_modules gespeichert werden
• Globale Installation : Systemweite CLI-Tools, die oft sudo erfordern

Q3. Welche Vorteile bietet die Verwendung von nvm?

A3.

nvm ermöglicht es Ihnen, sicher und effizient zwischen mehreren Node.js-Versionen zu wechseln, was es ideal für die Entwicklung mehrerer Projekte macht.

Q4. Was sollte ich tun, wenn npm-Abhängigkeiten kaputtgehen?

A4.

rm -rf node_modules package-lock.json
npm install

Q5. Sind npm WARN- und Audit-Nachrichten ein Problem?

A5.

Warnungen sind nicht fatal, deuten aber auf potenzielle Probleme hin. Für sicherheitsbezogene Warnungen können Sie versuchen:

npm audit fix

Q6. Was kann ich mit npm auf Ubuntu erstellen?

A6.

• Frontend-Frameworks (React, Vue, Svelte)
• Statische Site-Generatoren (Next.js, Nuxt)
• Backend-Anwendungen (Express, NestJS)
• CLI-Tools
• Testumgebungen

6. Schlussfolgerung: Meistern Sie npm auf Ubuntu

Dieser Artikel hat die Grundlagen der Installation und Nutzung von npm auf Ubuntu abgedeckt, von der Einrichtung bis zur Fehlerbehebung.

Der wichtigste Schritt ist es, hands-on zu experimentieren. Indem Sie Befehle ausführen und Fehlermeldungen verstehen, werden Sie Ihre Fähigkeiten als Entwickler stetig vertiefen.

Dies schließt die vollständige Anleitung zur Nutzung von npm auf Ubuntu ab. Wir hoffen, dass sie Ihnen hilft, eine effizientere und leistungsstärkere Entwicklungsumgebung aufzubauen.