So beheben Sie, dass der npm-Befehl nach der Installation von Node.js nicht gefunden wurde

Der Fehlernpm: Befehl nicht gefunden (oder‘npm’ wird unter Windows nicht als interner oder externer Befehlerkannt) bedeutet, dass Ihre Shell npm nicht finden kann, obwohl Sie möglicherweise Node.js installiert haben. Es handelt sich fast immer um ein PATH-Problem. Hier erfahren Sie, wie Sie das Problem auf jeder Plattform beheben können.

Warum das passiert

npm wird mit Node.js ausgeliefert. Wennnpm nicht gefunden wird, entweder wurde Node.js nicht korrekt installiert oder das Verzeichnis mitnpm befindet sich nicht im PATH Ihres Systems – der Liste der Orte, an denen Ihre Shell nach Befehlen sucht.

Schritt 1: Überprüfen Sie, ob Node.js tatsächlich installiert ist

# Check if node exists
node --version
# v20.11.0  → Node is installed, npm PATH issue
# command not found → Node itself isn't installed/in PATH

# Check npm
npm --version
which npm    # macOS/Linux — shows npm location
where npm    # Windows

Fix 1: Node.js neu installieren (am einfachsten)

Wenn wedernode nochnpm gefunden wird, installieren Sie Node.js ordnungsgemäß neu:

# Download the LTS installer from nodejs.org and run it
# The official installer adds Node and npm to PATH automatically

# Verify after install (open a NEW terminal window)
node --version
npm --version

Wichtig: Öffnen Sie immer einneues Terminalfenster nach der Installation – PATH-Änderungen gelten nicht für bereits geöffnete Terminals.

Fix 2: Verwenden Sie nvm (empfohlen für Entwickler)

Der Node Version Manager verarbeitet die Node-Installation und den PATH korrekt und ermöglicht einen einfachen Versionswechsel:

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

# Restart your terminal, then:
nvm install --lts      # install latest LTS Node
nvm use --lts          # use it
node --version         # verify
npm --version          # npm comes with it

# Windows — use nvm-windows instead
# Download from github.com/coreybutler/nvm-windows

Fix 3: Knoten manuell zum PATH hinzufügen (macOS/Linux)

# Find where node is installed
which node
# /usr/local/bin/node  or  /opt/homebrew/bin/node

# Add its directory to PATH in your shell config
# For zsh (~/.zshrc):
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# For bash (~/.bashrc or ~/.bash_profile):
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Fix 4: PATH unter Windows reparieren

# 1. Find Node's install location (usually):
#    C:\Program Files
odejs
# 2. Add to PATH:
#    - Search "Environment Variables" in Start menu
#    - Click "Environment Variables"
#    - Under "System variables", select "Path", click "Edit"
#    - Click "New", add: C:\Program Files
odejs#    - Click OK on all dialogs

# 3. Open a NEW Command Prompt/PowerShell and verify:
node --version
npm --version

Fix 5: Homebrew-Knoten unter macOS

# If you installed via Homebrew but it's not found
brew install node

# On Apple Silicon Macs, Homebrew is in /opt/homebrew
# Ensure it's in PATH:
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Relink if needed
brew link --overwrite node

Häufige Ursache: Probleme mit Berechtigungen oder globalen Verzeichnissen

# If npm works but global installs fail with permission errors,
# configure a user-level global directory (avoids sudo):
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Häufig gestellte Fragen

F: Ich habe Node installiert, aber npm wird immer noch nicht gefunden. Warum?
A: Am häufigsten müssen Sie ein NEUES Terminalfenster öffnen – PATH-Änderungen wirken sich nicht auf bereits geöffnete Terminals aus. Wenn das nicht funktioniert, befindet sich das Node-Verzeichnis nicht in Ihrem PATH oder die Installation war unvollständig. Installieren Sie NVM neu oder verwenden Sie es.

F: Sollte ich NVM oder das Direktinstallationsprogramm verwenden?
A: NVM wird Entwicklern empfohlen – es verwaltet PATH korrekt, vermeidet Berechtigungsprobleme und ermöglicht den Wechsel der Node-Versionen pro Projekt. Das Direktinstallationsprogramm eignet sich gut für einfache Einzelversions-Setups.

F: Node funktioniert, npm jedoch nicht. Wie ist das möglich?
A: Selten, aber es kann passieren, wenn der npm-Symlink unterbrochen oder entfernt wird. Installieren Sie Node.js neu oder führen Sienpm install -g npmaus wenn der Knoten funktioniert. Installieren Sie mit nvm die Node-Version neu.

F: Warum erhalte ich Berechtigungsfehler bei npm install -g?
A: Sie installieren in einem Systemverzeichnis, für das Administratorrechte erforderlich sind. Verwenden Sie niemalssudo npm – Konfigurieren Sie stattdessen ein Präfixverzeichnis auf Benutzerebene (siehe oben) oder verwenden Sie nvm, wodurch das Problem vollständig vermieden wird.

F: Woher weiß ich, welche PATH-Datei ich bearbeiten muss – .zshrc, .bashrc oder .bash_profile?
A: Überprüfen Sie Ihre Shell mitecho $SHELL. Wenn es zsh ist (Standard unter modernem macOS), bearbeiten Sie~/.zshrc. Wenn Bash, bearbeiten Sie~/.bashrc (Linux) oder~/.bash_profile (macOS).

Fazit

„npm: Befehl nicht gefunden“ ist ein PATH-Problem: Ihre Shell kann den Speicherort von npm nicht finden. Die schnellste und zuverlässigste Lösung istInstallation von Node.js über nvm, das PATH und Berechtigungen korrekt verarbeitet und Ihnen das Wechseln der Versionen ermöglicht. Andernfalls installieren Sie Node über das offizielle Installationsprogramm neu und öffnen Sie immer einneues Terminalfenster später. Wenn Node installiert, aber nicht in PATH ist, fügen Sie sein Verzeichnis (gefunden überwhich node) zu Ihrer Shell-Konfigurationsdatei hinzu. Neunzig Prozent der Fälle werden durch die Verwendung von NVM oder das Öffnen eines neuen Terminals gelöst.