Installieren von Node.js unter Windows

Artikel
12/20/2023

Wenn Sie noch nicht mit der Entwicklung mit Node.js vertraut sind und einen schnellen Einstieg finden möchten, damit Sie lernen können, führen Sie die folgenden Schritte aus, um Node.js direkt unter Windows zu installieren.

Hinweis

Wenn Sie Node.js professionell verwenden, Sie die Leistungsgeschwindigkeit und Kompatibilität von Systemaufrufen für wichtig halten, Docker-Container ausführen möchten, die Linux-Arbeitsbereiche nutzen, und vermeiden, sowohl Linux- als auch Windows-Buildskripts verwalten zu müssen, oder einfach die Verwendung einer Bash-Befehlszeile bevorzugen, dann installieren Sie Node.js unter Windows-Subsystem für Linux (genauer gesagt WSL 2).

Installieren von nvm-windows, Node.js und npm

Neben der Wahl, ob unter Windows oder WSL installiert werden soll, gibt es beim Installieren von Node.js weitere Optionen. Es wird empfohlen, einen Versions-Manager zu verwenden, da sich die Versionen sehr schnell ändern. Du musst wahrscheinlich je nach den Anforderungen einzelner Projekte, an denen du arbeitest, zwischen verschiedenen Node.js-Versionen wechseln. Node Version Manager (meist als „nvm“ bezeichnet) ist die beliebteste Methode zum Installieren mehrerer Versionen von Node.js, die allerdings nur für Mac und Linux verfügbar ist und unter Windows nicht unterstützt wird. Stattdessen empfehlen wir, „nvm-windows“ zu installieren, und damit anschließend Node.js und Node Package Manager (npm) zu installieren. Es gibt alternative Versions-Manager, die im nächsten Abschnitt behandelt werden.

Wichtig

Es wird immer empfohlen, vorhandene Installationen von Node.js oder npm vom Betriebssystem zu entfernen, bevor du einen Versions-Manager installierst, da die unterschiedlichen Installationstypen zu ungewöhnlichen und verwirrenden Konflikten führen können. Dies umfasst auch das Löschen der vorhandenen Node.js-Installationsverzeichnisse (z. B. „C:\Programme\nodejs“), die möglicherweise verbleiben. Der von nvm generierte Symlink überschreibt vorhandene (auch leere) Installationsverzeichnisse nicht. Hilfe beim Entfernen früherer Installationen findest du unter Vollständiges Entfernen von Node.js aus Windows.)

Warnung

nvm ist für die Installation pro Benutzer konzipiert und wird pro Shell aufgerufen. Es ist nicht für freigegebene Entwicklerboxen oder Buildserver mit mehreren Build-Agents konzipiert. nvm funktioniert mithilfe einer symbolischen Verknüpfung. Die Verwendung von nvm in freigegebenen Szenarien führt zu einem Problem, da dieser Link auf den App-Datenordner eines Benutzers verweist. Wenn also Benutzer x nvm use lts ausführt, verweist der Link den Knoten für die gesamte Box auf den App-Datenordner. Wenn Benutzer y den Knoten oder npm ausführt, wird er angewiesen, Dateien unter dem Benutzerkonto von x auszuführen, und im Fall von npm -g ändert er die Dateien von x, was standardmäßig nicht zulässig ist. nvm ist also nur für eine Entwicklerbox vorgeschrieben. Dies gilt auch für Buildserver. Wenn sich zwei Build-Agents auf derselben VM/Box befinden, können sie konkurrieren und ungewöhnliches Verhalten in den Builds verursachen.

Folgen Sie den Installationsanweisungen im windows-nvm-Repository. Wir empfehlen die Verwendung des Installationsprogramms, aber wenn Sie Ihre Bedürfnisse besser kennen, können Sie auch die manuelle Installation in Betracht ziehen. Das Installationsprogramm verweist Sie auf die Seite mit den Releases für die neueste Version.
Lade die Datei nvm-setup.zip für das neueste Release herunter.
Öffne nach dem Herunterladen die ZIP-Datei und dann die Datei nvm-setup.exe.
Der nvm-Installations-Assistent für Windows führt dich durch die Einrichtungsschritte, einschließlich der Auswahl des Verzeichnisses, in dem sowohl nvm-windows als auch Node.js installiert werden.
Gehen Sie nach Abschluss der Installation wie folgt vor: Öffnen Sie PowerShell (am besten mit erweiterten Administratorrechten), und versuchen Sie, mit „windows-nvm“ aufzulisten, welche Versionen von Node derzeit installiert sind (zu diesem Zeitpunkt sollte es keine geben): nvm ls
Installiere das aktuelle Release von Node.js (zum Testen der neuesten Featureverbesserungen, das aber eher Fehler enthält als die LTS-Version): nvm install latest
Installiere das neueste stabile LTS-Release von Node.js (empfohlen), indem du zuerst nach der aktuellen LTS-Versionsnummer suchst: nvm list available. Installiere dann diese LTS-Versionsnummer mit: nvm install <version> (<version> durch die Versionsnummer ersetzen, also nvm install 12.14.0).
Liste die installierten Versionen von Node auf: nvm ls. Nun sollten die beiden Versionen, die du soeben installiert hast, aufgeführt werden.
Wähle nach der Installation der benötigten Node.js-Versionsnummern die gewünschte Version aus, indem du Folgendes eingibst: nvm use <version> (wobei <version> durch die Nummer ersetzt wird, also nvm use 12.9.0).
Um die Version von Node.js zu ändern, die du für ein Projekt verwenden möchtest, erstellst du ein neues Projektverzeichnis mkdir NodeTest und wechselst in das Verzeichnis (cd NodeTest). Gib dann nvm use <version> ein, und ersetze <version> durch die gewünschte Versionsnummer (z. B. „v10.16.3“).
Mit npm --version überprüfst du, welche Version von npm installiert ist. Diese Versionsnummer wird automatisch in die npm-Version geändert, die deiner aktuellen Version von Node.js zugeordnet ist.

Alternative Versions-Manager

Obwohl windows-nvm derzeit der beliebteste Versions-Manager für Node ist, gibt es auch Alternativen:

nvs (Node Version Switcher) ist eine plattformübergreifende Alternative zu nvm mit der Möglichkeit der Integration mit VS Code.
Volta ist ein neuer Versions-Manager des LinkedIn-Teams, der mit höherer Geschwindigkeit und plattformübergreifender Unterstützung wirbt.

Wechsele zum Installieren von Volta als Versions-Manager (anstelle von windows-nvm) zum Abschnitt Windows-Installation im Leitfaden für die ersten Schritte. Lade anschließend das Windows-Installationsprogramm herunter, führe es aus, und befolge die Setupanweisungen.

Wichtig

Vor der Installation von Volta musst du sicherstellen, dass auf dem Windows-Computer der Entwicklermodus aktiviert ist.

Weitere Informationen zur Verwendung von Volta zum Installieren mehrerer Versionen von Node.js unter Windows findest du in der Volta-Dokumentation.

Installieren von Visual Studio Code

Es wird empfohlen, für die Entwicklung mit Node.js unter Windows Visual Studio Code zu installieren. Hilfe finden Sie im Tutorial zu Node.js in Visual Studio Code.

Alternative Code-Editoren

Wenn Sie es vorziehen, einen anderen Code-Editor oder eine andere IDE als Visual Studio Code zu verwenden, sind die folgenden Optionen auch für Ihre Node.js-Entwicklungsumgebung:

Installieren von Git

Wenn du beabsichtigst, zusammen mit anderen zusammenzuarbeiten oder das Projekt an einem Open-Source-Standort (wie GitHub) zu hosten, unterstützt VS Code die Versionskontrolle mit Git. Auf der Registerkarte „Quellcodeverwaltung“ in VS Code werden alle Änderungen nachverfolgt und gängige Git-Befehle („Add“, „Commit“, „Push“, „Pull“) direkt in die Benutzeroberfläche integriert. Sie müssen zunächst Git installieren, um den Bereich „Quellcodeverwaltung“ zu aktivieren.

Laden Sie Git für Windows von der git-scm-Website herunter, und installieren Sie Git.
Ein Installations-Assistent ist enthalten, der Ihnen eine Reihe von Fragen zu den Einstellungen für die Git-Installation stellt. Sie sollten alle Standardeinstellungen verwenden, sofern kein bestimmter Grund vorliegt, etwas zu ändern.
Wenn Sie noch nie zuvor mit Git gearbeitet haben, können Sie GitHub-Leitfäden für den Einstieg nutzen.
Es wird empfohlen, deinen Node-Projekten eine Datei .gitignore hinzuzufügen. Dies ist die GITIGNORE-Standardvorlage für Node.js von GitHub.

Verwenden des Windows-Subsystems für Linux für die Produktion

Die direkte Verwendung von Node.js unter Windows eignet sich hervorragend zum Erlernen und Experimentieren mit den Möglichkeiten. Wenn du bereit bist, produktionsfertige Web-Apps zu erstellen, die in der Regel auf einem Linux-basierten Server bereitgestellt werden, solltest du das Windows-Subsystem für Linux Version 2 (WSL 2) für die Entwicklung von Node.js-Web-Apps verwenden. Viele Node.js-Pakete und -Frameworks werden für eine *nix-Umgebung erstellt, und die meisten Node.js-Apps werden unter Linux bereitgestellt. Die Entwicklung im WSL stellt daher die Konsistenz zwischen deiner Entwicklungsumgebung und den Produktionsumgebungen sicher. Informationen zum Einrichten einer WSL-Entwicklungsumgebung findest du unter Einrichten der Node.js-Entwicklungsumgebung mit WSL 2.