Node.js und Paketmanager

Node.js

Node.js ist eine Laufzeitumgebung, die es ermöglicht, JavaScript-Code außerhalb des Browsers auszuführen. Bei der Installation wird dir auch der Node Paketmanager (npm) eingerichtet, der die Installation und Verwaltung von JavaScript-Bibliotheken ermöglicht.

Die Installation ist je nach Betriebssystem unterschiedlich.

Die einfachste Möglichkeit, Node.js für macOS zu installieren, ist über Homebrew, einem Paketmanager für macOS. Wenn du den zuvor eingerichtet hast, führe zur Installation von Node.js folgenden Befehl im Terminal aus:

brew install node@22

Alternativ kannst du Node.js auch manuell installieren. Lade dir dazu den Node.js-Installer in der LTS-Version herunter und führe die Installation durch.

Wenn du Node.js installiert hast, kannst du im Terminal überprüfen, ob die Installation erfolgreich war oder direkt mit dem Website-Starterkit fortfahren.

Die einfachste Möglichkeit, Node.js für Windows zu installieren, ist über das Installationspaket. Lade dir jetzt Node.js in der LTS-Version (Long Term Support) von der offiziellen Node.js-Website herunter und installiere es.

Während der Installation sind ein paar Dinge zu beachten: Lasse die folgende Vorauswahl unverändert und klicke auf Next.

Wähle im folgenden Dialog die Checkbox aus, um weitere Tools wie Chocolatey zu installieren, und klicke auf Next. Diese können bei manchen Anwendungen hilfreich sein.

Nach der erfolgreichen Installation öffnet sich das Terminal zur Installation der zuvor ausgewählten Tools. Starte die Installation durch Drücken einer beliebigen Taste.

💡 Hinweis: Lass dich von den Statusinformationen und Warnungen im Installationsprozess nicht irritieren und gib der Installation ein paar Minuten Zeit, bevor du das Fenster schließt.

Ausführung von Scripten erlauben

Windows blockiert standardmäßig das Ausführen von Skripten in der PowerShell. Um das zu ändern, öffne die PowerShell als Administrator und führe den folgenden Befehl aus:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

Wenn du Node.js installiert hast, kannst du im Terminal überprüfen, ob die Installation erfolgreich war oder direkt mit dem Website-Starterkit fortfahren.

Alternative Paketmanager

Neben npm gibt es weitere Paketmanager, die du für die Installation von JavaScript-Bibliotheken verwenden kannst. Das wären zum Beispiel Yarn oder pnpm. Beide bieten Vorteile in Bezug auf Geschwindigkeit und geringerem Speicherplatz.

💡 Hinweis: Wenn du bisher noch nicht mit einem Paketmanager gearbeitet hast, empfehlen wir dir die Verwendung von npm.

Solltest du dich für Yarn oder pnpm entscheiden, sieh dir auf jeden Fall den nächsten Abschnitt Corepack an.

Mit Corepack kannst du den Paketmanager auf Projektbasis festlegen. Das bedeutet, dass du nicht einen Paketmanager in einer Version für all deine Website-Projekte verwendest, sondern jedes Projekt seine eigene Paketmanager-Version verwendet. Das beugt Konflikten vor und sorgt für eine saubere Projektstruktur.

Homebrew und Chocolatey

Wozu soll das gut sein, fragst du dich?

Ganz einfach: Mit Homebrew und Chocolatey kannst du Softwarepakete und Bibliotheken mit einem Befehl installieren, ohne dass du erst bei Google nach dem Download-Link suchst, die Datei herunterlädst, doppelklickst und durch den Installationsprozess klickst, nur um anschließend die Installationsdatei wieder zu löschen.

Die beiden Paketmanager sparen dir also viel Zeit. Und so installierst du sie:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install node

brew install firefox

# Installation aller Updates
brew upgrade

# Installation eines spezifischen Updates
brew upgrade <paketname>

brew doctor && brew update

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

choco install nodejs

choco install firefox

choco upgrade all

choco upgrade chocolatey

Corepack

Wenn du mit verschiedenen Projekten arbeitest, solltest du darauf achten, nicht mehrere Paketmanager (npm, yarn, pnpm) global installiert zu haben. Das kann schnell zu Inkompatibilitäten führen, insbesondere wenn du aktuelle und ältere Projekte gleichzeitig betreust. Im schlimmsten Fall kannst du nach dem Update des Paketmanagers oder deines Betriebssystems ein Projekt nicht mehr starten.

Für eine saubere Verwaltung empfiehlt sich daher die Nutzung von Corepack. Es fungiert als Vermittler zwischen deinem Projekt und dem Paketmanager, sodass du Projekte unabhängig voneinander betreiben kannst. Corepack ermöglicht es dir, den Paketmanager und dessen Version auf Projektbasis festzulegen.

Das könnte zum Beispiel so aussehen:

Wenn du Node.js installiert hast, ist auch Corepack bereits installiert. Allerdings ist es standardmäßig oft deaktiviert.

Corepack aktivieren

Bevor du Corepack nutzen kannst, musst du es einmalig auf deinem Computer aktivieren. Das sorgt dafür, dass die Befehle pnpm und yarn verfügbar gemacht werden, ohne dass du sie separat installieren musst.

corepack enable

Paketmanager festlegen

Du kannst den Paketmanager und dessen Version für dein Projekt festlegen, indem du im Terminal in das Projektverzeichnis wechselst und den Befehl corepack use verwendest:

corepack use pnpm@latest # Installiert pnpm in der neuesten Version
corepack use yarn@3.2.3 # Installiert Yarn in der Version 3.2.3

Corepack wird in deiner Projektdatei package.json eine Zeile hinzufügen, die den Paketmanager und dessen Version festlegt:

"packageManager": "yarn@3.2.3+sha224.953c8233f7a92884eee2de69a1b92d1f2ec1655e66d08071ba9a02fa"

Vorhandenes Projekt nutzen

Wenn du ein Projekt herunterlädst (z. B. von GitHub), das Corepack verwendet, musst du nichts weiter tun, als den Paketmanager auszuführen (vorausgesetzt, du hast corepack enable einmalig ausgeführt).

Wenn in der package.json beispielsweise pnpm festgelegt ist, kannst du einfach pnpm install tippen. Corepack erkennt automatisch die geforderte Version, lädt sie im Hintergrund herunter und führt sie aus. Du musst dich nicht darum kümmern, ob du die richtige Version installiert hast.

Probleme mit global installierten Paketmanagern

Wenn du die Paketmanager npm, yarn oder pnpm bereits systemweit (global) installiert hast, kann es zu Konflikten kommen. Corepack verwaltet die Paketmanager auf Projektebene und sorgt dafür, dass immer die passende Version verwendet wird. Globale Installationen sind damit nicht mehr nötig und können sogar stören.

Empfehlung: Deinstalliere die Paketmanager, falls du sie global installiert hast. So vermeidest du Versionskonflikte und stellst sicher, dass Corepack die Verwaltung übernimmt.

So deinstallierst du die Paketmanager:

# Falls du sie mit npm installiert hast:
npm uninstall -g npm yarn pnpm

# Falls du sie mit Homebrew installiert hast:
brew uninstall npm yarn pnpm

# Falls du sie mit Chocolatey installiert hast:
choco uninstall npm yarn pnpm

Danach übernimmt Corepack die Verwaltung der Paketmanager für jedes Projekt individuell. Mehr dazu findest du oben im Tutorial.

Installation überprüfen

Wenn du bisher noch keine Berührungspunkte mit einem Terminal hattest, keine Sorge! So kannst du prüfen, ob Node.js und die Paketmanager korrekt installiert sind.

Öffne unter macOS das Terminal bzw. unter Windows die PowerShell. Bei der Eingabe der folgenden Befehle erhältst du entweder eine Versionsnummer, was bedeutet, dass die Software korrekt installiert ist, oder eine Fehlermeldung, wenn sie nicht installiert ist.

# Überprüfung von Node.js
node -v

# Überprüfung von npm
npm -v

# Überprüfung von Corepack
corepack -v

# Überprüfung von Homebrew (macOS)
brew -v

# Überprüfung von Chocolatey (Windows)
choco -v

Tipps

• Du erhältst den Fehler command not found

  Bevor du eine Fehleranalyse startest, starte dein Terminal oder die PowerShell neu. Manchmal werden Umgebungsvariablen erst nach einem Neustart aktualisiert. Die Umgebungsvariablen helfen dem System dabei, die installierten Programme zu finden.

• Du hattest zuvor schon Paketmanager installiert?

  Wenn du mit verschiedenen Projekten arbeitest, solltest du darauf achten, nicht mehrere Paketmanager (npm, yarn, pnpm) global installiert zu haben. Für eine saubere Verwaltung empfiehlt sich die Nutzung von Corepack. Mehr dazu findest du im Corepack-Tutorial.

Weitere mögliche Fehler und deren Lösungen findest du auf der Seite Fehler beheben.