Node.js installieren: Windows, macOS und Linux
Wir zeigen Schritt für Schritt für drei Betriebssysteme, wie Sie Node.js mit dem offiziellen Installer oder mit nvm installieren, Versionen wechseln und die Installation prüfen.
Aurora YazılımRedaktionsteam
6 Min. Lesezeit
Für die Node.js-Installation laden Sie von nodejs.org die LTS-Version herunter und starten den Installer. Wollen Sie in mehreren Projekten unterschiedliche Versionen nutzen, installieren Sie unter macOS und Linux mit nvm, unter Windows mit nvm-windows. Prüfen Sie die Version anschließend im Terminal mit node -v und npm -v; geben beide Befehle eine Versionsnummer aus, ist die Installation abgeschlossen.
Was ist Node.js und warum installiert man es?
Node.js ist eine Laufzeitumgebung, die JavaScript außerhalb des Browsers direkt auf Ihrem Rechner oder auf einem Server ausführt. Fast jedes moderne Webprojekt braucht Node.js während der Entwicklung: Pakete installieren, Builds erstellen und lokale Entwicklungsserver starten – das alles läuft darüber.
Auch wenn Sie Tools wie React, Vite, Next.js oder Tailwind gar nicht nutzen: Wollen Sie ein Projekt auf Ihrem Rechner zum Laufen bringen, ist der erste Schritt meist npm install. Dieser Befehl gehört zum Paketmanager npm, der mit Node.js ausgeliefert wird – ohne Node.js kommen Sie an diesem Schritt also nicht vorbei.
In dieser Anleitung beschreiben wir zwei Wege: den offiziellen Installer für alle, die mit nur einer Version arbeiten, und einen Versionsmanager für alle, die mehrere Projekte betreuen. Welcher Weg zu Ihnen passt, zeigt die folgende Tabelle.
| Methode | Für wen | Vorteil | Nachteil |
|---|---|---|---|
| Offizieller Installer (.msi / .pkg) | Einsteiger, einzelnes Projekt | Der einfachste Weg, wenige Klicks | Versionswechsel sind mühsam |
| nvm / nvm-windows | Mehrere Projekte, Teamarbeit | Wechsel zwischen Versionen mit einem Befehl | Die Ersteinrichtung ist etwas technischer |
| Paketmanager (brew, apt, winget) | Nutzer, die das Terminal mögen | Installation und Update per Befehl | Die Version im Repository kann veraltet sein |
Was brauchen Sie vor der Installation?
Node.js ist schlank, doch ein paar Vorbereitungen verhindern spätere Probleme. Haben Sie bereits eine ältere Node.js-Version auf dem Rechner, kann die Installation von nvm ohne vorherige Deinstallation zu einem PATH-Konflikt führen.
Achten Sie auch auf die Prozessorarchitektur. Auf Macs mit Apple Silicon (M-Serie) und auf ARM-basierten Windows-Geräten wählt der Installer die richtige Architektur meist selbst; laden Sie manuell herunter, verwechseln Sie x64 und ARM64 nicht. Eine falsche Architektur läuft zwar eventuell, aber langsamer, und manche nativen Pakete lassen sich nicht kompilieren.
Auf Firmenrechnern können ein Proxy oder eine Firewall den Paketdownload von npm blockieren. Befinden Sie sich in einem solchen Netzwerk, bitten Sie Ihr IT-Team vor der Installation um Zugriff auf die npm-Registry-Adresse (registry.npmjs.org).
- Administratorrechte: Für den offiziellen Installer unter Windows und macOS erforderlich; nvm wird in den Benutzerordner installiert und braucht sie meist nicht.
- Terminal: Unter Windows genügen PowerShell oder das Windows Terminal, unter macOS das Terminal, unter Linux die Standard-Shell.
- Alte Installation entfernen: Wollen Sie auf einen Versionsmanager umsteigen, deinstallieren Sie zuerst das vorhandene Node.js über Einstellungen > Apps oder Ihren Paketmanager.
- Versionswahl: Wählen Sie für Produktion und zum Lernen die LTS-Version (Long Term Support); die Current-Version ist für alle gedacht, die neue Funktionen früh sehen möchten.
Node.js unter Windows installieren
Unter Windows gibt es drei Wege: den offiziellen .msi-Installer, den Windows-eigenen Paketmanager winget und nvm-windows für die Versionsverwaltung. Egal, wofür Sie sich entscheiden: Schließen Sie nach der Installation alle offenen Terminals und öffnen Sie sie neu, sonst ist die neue PATH-Einstellung nicht sichtbar.
Mit dem offiziellen Installer
Laden Sie von nodejs.org die LTS-.msi-Datei für Windows herunter, starten Sie den Installer und bleiben Sie bei den Standardoptionen. Der Installer richtet zusammen mit Node.js auch npm ein und trägt es automatisch in den PATH ein.
Mit winget
Mit winget, das in Windows 10 und 11 enthalten ist, installieren Sie die LTS-Version mit einem einzigen Befehl:
winget install OpenJS.NodeJS.LTSMit nvm-windows
Brauchen Sie mehrere Versionen, installieren Sie nvm-windows; es ist ein eigenständiges Projekt neben nvm für macOS/Linux, die Befehle ähneln sich aber. Öffnen Sie nach der Installation PowerShell als Administrator und führen Sie diese Befehle aus:
winget install CoreyButler.NVMforWindows
# Terminal schließen und neu öffnen
nvm install lts
nvm use lts
nvm listInstallation mit nvm unter macOS und Linux
Unter macOS und Linux ist nvm (Node Version Manager) der solideste Weg. nvm installiert Node.js in Ihren Benutzerordner; so brauchen Sie für globale Pakete kein sudo und haben keinen Ärger mit Berechtigungsfehlern.
Der folgende Befehl lädt das Installationsskript von nvm herunter und führt es aus. Die offizielle README empfiehlt eine Adresse mit Versions-Tag; am sichersten kopieren Sie den aktuellsten Befehl von der nvm-Seite auf GitHub.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
# Shell neu laden (je nach verwendeter Shell eine Variante wählen)
source ~/.bashrc
source ~/.zshrc
# Prüfen, ob nvm installiert wurde
command -v nvmnvm install --lts
nvm use --lts
nvm alias default 'lts/*'macOS-Installation mit Homebrew
Nutzen Sie Homebrew, funktioniert auch der Befehl brew install node. Er installiert jedoch in der Regel die neueste Version; wollen Sie bei LTS bleiben, ist nvm flexibler.
brew install nodeRepositories der Linux-Distributionen
Unter Ubuntu oder Debian funktioniert sudo apt install nodejs npm, doch die Version im Repository ist oft älter, als aktuelle Projekte verlangen. Deshalb empfehlen wir auf Entwicklungsrechnern nvm.
Wie prüfe ich die Installation?
Öffnen Sie nach Abschluss der Installation ein neues Terminal und führen Sie die folgenden Befehle aus. Beide müssen eine Versionsnummer zurückgeben. Mit einem kleinen Testskript sehen Sie dann, dass Node.js Code ausführt.
- Die Ausgabe von node -v ist eine Versionsnummer, die mit v beginnt.
- npm -v gibt nur Ziffern aus; npm wird zusammen mit Node.js ausgeliefert.
- Gibt der Testbefehl die Nachricht aus, ist Ihre Umgebung bereit; als Nächstes folgt die Paketverwaltung mit den npm-Befehlen.
node -v
npm -v
node -e "console.log('Node.js läuft')"Wie wechselt man die Node-Version?
Verschiedene Projekte verlangen unterschiedliche Node.js-Versionen: Ein altes Projekt läuft mit einer älteren Version, ein neues mit der aktuellen LTS. Den Node-Versionswechsel erledigen Sie mit nvm in wenigen Sekunden.
Legen Sie eine .nvmrc-Datei in den Stammordner des Projekts, nutzt das ganze Team dieselbe Version. Es genügt, in den Ordner zu wechseln und nvm use einzugeben, um auf die in der Datei angegebene Version umzuschalten (nvm-windows liest die .nvmrc-Datei nicht; dort tragen Sie die Version von Hand ein).
# Installierte Versionen
nvm ls
# LTS-Versionen auf dem Remote-Server
nvm ls-remote --lts
# Bestimmte Hauptversion installieren und wechseln (Beispiel)
nvm install 20
nvm use 20
# Im Projekt verwendete Version speichern
node -v > .nvmrc
nvm useHäufige Fehler und ihre Lösungen
Die meisten Probleme bei der Node.js-Installation betreffen PATH und Berechtigungen. Die folgende Liste fasst die häufigsten Fehler und schnelle Lösungen zusammen.
Der Befehl node wird nicht erkannt
Die Fehlermeldung »node is not recognized« unter Windows tritt meist auf, weil das Terminal schon vor der Installation geöffnet war. Schließen Sie alle Terminals und VS Code und öffnen Sie sie neu; besteht das Problem weiter, prüfen Sie, ob der Node.js-Ordner in der PATH-Variable steht.
PowerShell blockiert Skripte
PowerShell kann sich weigern, die Datei npm.ps1 auszuführen. Das Problem löst sich, wenn Sie die Ausführungsrichtlinie nur für Ihren eigenen Benutzer lockern:
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedEACCES-Berechtigungsfehler
Erhalten Sie unter macOS oder Linux bei npm install -g den Fehler EACCES, wurde Node.js in einen Systemordner installiert. Führen Sie npm nicht mit sudo aus; entfernen Sie die vorhandene Installation und installieren Sie sie mit nvm neu.
nvm: command not found
Das Installationsskript trägt die nvm-Zeilen in Ihr Shell-Profil ein, aber das geöffnete Terminal weiß davon nichts. Führen Sie source ~/.zshrc oder source ~/.bashrc aus oder öffnen Sie das Terminal neu.
Was tun nach der Installation?
Ist Node.js bereit, richten Sie den Rest der Entwicklungsumgebung ein: Für einen Editor hilft unsere Anleitung zur VS-Code-Installation, zum Sichern und Teilen Ihres Codes die Anleitung Projekt auf GitHub hochladen. Alle Schritt-für-Schritt-Anleitungen finden Sie in der Kategorie Installationsanleitungen.
Entwickeln Sie ein Webprojekt für ein Unternehmen, tragen Node.js-basierte Tools dazu bei, die Seitengeschwindigkeit zu steigern, indem sie beim Build Bilder, CSS und JavaScript verkleinern. Dieses Thema behandeln wir ausführlich in unserer Speed- und Performance-Optimierung.
Haben Sie kein eigenes Team oder braucht Ihr Projekt ein umfangreiches System wie eine E-Commerce-Infrastruktur, spart es Zeit, Einrichtung und Entwicklung einem erfahrenen Team zu überlassen. Bei Projekten für eine Unternehmenswebsite und eine E-Commerce-Infrastruktur richten wir die gesamte Umgebung ein, und Sie konzentrieren sich allein auf die Inhalte.
Häufig gestellte Fragen
01Sollte ich die LTS- oder die Current-Version installieren?
Wählen Sie für Lernen, Geschäftsprojekte und Server die LTS-Version; sie erhält lange Sicherheitsupdates. Die Current-Version eignet sich für alle, die neue Funktionen früh ausprobieren möchten, und hat einen kürzeren Supportzeitraum.
02Muss ich npm separat installieren?
Nein. Der offizielle Installer, nvm und nvm-windows installieren npm zusammen mit Node.js. Möchten Sie npm aktualisieren, nutzen Sie den Befehl npm install -g npm.
03Wie entferne ich Node.js vollständig von meinem Rechner?
Deinstallieren Sie es unter Windows über Einstellungen > Apps und löschen Sie die Ordner npm und npm-cache im Benutzerordner. Haben Sie mit nvm installiert, können Sie die Versionen einzeln mit dem Befehl nvm uninstall entfernen.
04Sollte ich nvm auch auf dem Server verwenden?
Auf Entwicklungsservern mit einem einzigen Benutzer ist nvm praktisch. Auf Produktionsservern lassen sich reproduzierbare Methoden wie das offizielle oder von Node.js empfohlene Paket-Repository der Distribution oder ein Docker-Image leichter verwalten.
Node.js richtig zu installieren sorgt dafür, dass alle weiteren Entwicklungsschritte reibungslos laufen: Eine LTS-Version, flexible Versionsverwaltung mit nvm und ein Prüfbefehl genügen. Möchten Sie nicht bei null anfangen und suchen eine maßgeschneiderte Software oder eine Webdesign-Lösung für Ihr Unternehmen, informieren Sie sich über die individuellen Softwarelösungen von Aurora Yazılım oder kontaktieren Sie uns.
