- Docs
- Hilfe
- npm-Installation
Docs for VelinStyle 1.3.x · verified against 1.3.0
npm-Installation funktioniert nicht 1.3.0
Löse Paket-, Versions- und Windows-Modulprobleme, bevor du dein Projekt umbaust. English
Problem
Die Installation scheitert, das falsche Paket wird aufgelöst, oder die CLI fehlt nach dem Install.
Erste Prüfung
Führe zuerst die allgemeine Diagnose im Projektverzeichnis aus.
npx @birdapi/velinstyle doctor
Tiefer prüfen
npm install @birdapi/velinstyle@1.3.0
npx @birdapi/velinstyle doctor
Schnellcheck
- Im richtigen Projektverzeichnis ausführen.
- Nur dokumentierte Profile und Flags verwenden.
- Nach jeder Änderung erneut prüfen.
Falscher Paketname
Ursache: Nacktes velinstyle ist nicht das veröffentlichte Paket; der Scoped-Name ist Pflicht.
- Lösung 1: Installiere mit
npm install @birdapi/velinstyle@1.3.0. - Lösung 2: Ersetze nacktes
npx velinstyle durch npx @birdapi/velinstyle …. - Lösung 3: Prüfe, dass
package.json @birdapi/velinstyle listet, nicht einen unscoped Namen.
Erneut prüfennpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
Eine ältere Version ist installiert
Ursache: Docs und CLI-Beispiele für 1.3.x brauchen Paket 1.3.0 (oder später zur Docs-Linie).
- Lösung 1: Pinne oder upgrade auf
@birdapi/velinstyle@1.3.0. - Lösung 2: Führe
npx @birdapi/velinstyle doctor erneut aus und vergleiche die gemeldete Version. - Lösung 3: Lösche einen veralteten Global-/npx-Cache erst, wenn die lokale Dependency stimmt.
Erneut prüfennpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
Windows-/ESM-Auflösung schlägt fehl
Ursache: Node kann die Package-Exports oder den CLI-Einstieg auf diesem Rechner nicht auflösen.
- Lösung 1: Nutze eine aktuelle Node-LTS und installiere
@birdapi/velinstyle im Projektroot neu. - Lösung 2: Importiere nur dokumentierte Exports wie
@birdapi/velinstyle/css oder /motion. - Lösung 3: Starte die CLI mit
npx @birdapi/velinstyle doctor aus dem Projektverzeichnis.
Erneut prüfennpx @birdapi/velinstyle doctor
npx @birdapi/velinstyle check ./index.html --profile docs
VelinStyle