91 lines
3.0 KiB
Markdown
91 lines
3.0 KiB
Markdown
# Velinkungsproblem von globalen Modulen
|
||
|
||
Bei **nvm-windows** liegt das Problem an einem bekannten Mechanismus:
|
||
|
||
`nvm-windows` verwaltet Node-Versionen über einen **Symlink** (standardmäßig `C:\Program Files\nodejs`). Dieser Symlink zeigt dynamisch auf die gerade aktive Node-Version unter `%APPDATA%\nvm\v<version>`.
|
||
|
||
Wenn du `npm install -g <package>` ausführst, gibt es zwei typische Szenarien, warum das Binary nicht mehr im `PATH` landet:
|
||
|
||
1. **Ein abweichendes oder altes globales `prefix` in der `.npmrc`:** Wenn dort noch ein hartkodierter Pfad (wie `%APPDATA%\npm`) hinterlegt ist, legt npm die `.cmd`-Dateien dort ab, aber nvm-windows bindet diesen Pfad **nicht** in den `PATH` ein – nvm erwartet globale Pakete direkt im Symlink-Verzeichnis der jeweiligen Node-Version.
|
||
2. **Fehlende Berechtigungen im Node-Symlink:** Liegt Node unter `C:\Program Files\nodejs`, kann npm ohne Admin-Rechte dort keine `.cmd`-Dateien anlegen und weicht stillschweigend aus.
|
||
|
||
---
|
||
|
||
### Schritt 1: Prüfen, wo npm globale Pakete aktuell ablegt
|
||
|
||
Führe in der PowerShell aus:
|
||
|
||
```powershell
|
||
npm config get prefix
|
||
|
||
```
|
||
|
||
* **Fall A (Standard bei nvm-windows):** Der Pfad zeigt auf das aktive Symlink-Verzeichnis (z. B. `C:\Program Files\nodejs`). Hier müssten die `.cmd`-Dateien liegen.
|
||
* **Fall B (Häufige Ursache):** Der Pfad zeigt auf `C:\Users\<Name>\AppData\Roaming\npm`. In diesem Fall findet Windows die Befehle nicht, weil dieser Ordner bei nvm-windows **nicht** im `PATH` steht.
|
||
|
||
---
|
||
|
||
### Lösungsweg 1: Den dedizierten npm-Ordner nutzen (Empfohlen & Best Practice)
|
||
|
||
Damit globale Pakete auch bei einem Node-Versionswechsel über `nvm use` erhalten bleiben und keine Admin-Rechte im Programmverzeichnis nötig sind, bindet man den globalen npm-Pfad fest ein.
|
||
|
||
1. **Globales Prefix in npm festlegen:**
|
||
```powershell
|
||
npm config set prefix "$env:APPDATA\npm"
|
||
|
||
```
|
||
|
||
|
||
2. **Diesen Ordner dauerhaft in den Benutzer-`PATH` eintragen:**
|
||
```powershell
|
||
[Environment]::SetEnvironmentVariable(
|
||
"Path",
|
||
[Environment]::GetEnvironmentVariable("Path", "User") + ";$env:APPDATA\npm",
|
||
"User"
|
||
)
|
||
|
||
```
|
||
|
||
|
||
3. **Paket nochmals global installieren:**
|
||
```powershell
|
||
npm install -g gulp-cli
|
||
|
||
```
|
||
|
||
|
||
4. **Terminal neu starten** (Windows Terminal / PowerShell schließen und neu öffnen), danach testen:
|
||
```powershell
|
||
gulp -v
|
||
|
||
```
|
||
|
||
---
|
||
|
||
### Lösungsweg 2: Den nvm-Standard wiederherstellen
|
||
|
||
Falls du möchtest, dass nvm-windows globale Pakete strikt pro Node-Version im jeweiligen Versionsordner verwaltet:
|
||
|
||
1. **Globales Prefix zurücksetzen:**
|
||
```powershell
|
||
npm config delete prefix
|
||
|
||
```
|
||
|
||
|
||
2. **Prüfen, ob der nvm-Symlink im `PATH` vorhanden ist:**
|
||
```powershell
|
||
$env:PATH -split ';' | Select-String "nodejs"
|
||
|
||
```
|
||
|
||
|
||
Hier muss der nvm-Symlink (`C:\Program Files\nodejs` oder dein benutzerdefinierter Pfad) auftauchen.
|
||
3. **Installieren:**
|
||
```powershell
|
||
npm install -g gulp-cli
|
||
|
||
```
|
||
|
||
|
||
*(Hinweis: Falls eine Fehlermeldung bezüglich `EPERM` oder fehlender Schreibrechte auftaucht, die Konsole einmalig als Administrator ausführen oder Lösungsweg 1 wählen).* |