03_js-dom/docs/nvm-globale-module.md

@@ -0,0 +1,91 @@
+# 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).*