Versioning & Packages

package.json-Editor

Eine Manifestdatei bearbeiten, Fehler lokalisieren und Abhängigkeiten sortieren. Skripte und Exportbedingungen behalten ihre Reihenfolge.

package.json-Editor

Manifest eingeben

Formatiertes Ergebnis

Das Manifest bleibt im Browser. Keine Registerabfrage und keine Skriptausführung.

Feldhinweise und Grenzen

name bezeichnet das Paket. Es gelten Regeln für neue Pakete; lokale Projekte dürfen es weglassen.

Prüft eingebundene Manifestregeln, Namen und Stammversion. Externe Werkzeugkonfigurationen bleiben ohne eigene Prüfung erhalten.

Ein Objekt, 100.000 UTF-16-Codeeinheiten, Tiefe 100. Unsichere Ganzzahlen und Überläufe werden abgelehnt. Abhängigkeitsangaben werden nur als Zeichenketten geprüft.

Abhängigkeitsgruppen

dependencies: 0 · devDependencies: 0 · peerDependencies: 0 · optionalDependencies: 0

Keine Abhängigkeiten anzuzeigen.

Eingabe oder Optionen geändert. Vor dem Export erneut prüfen.

Der package.json-Editor hilft bei schwer lesbaren Änderungen nach einem Merge. Gültige JSON-Syntax allein sagt noch nicht, ob ein Abhängigkeitswert den richtigen Typ hat.

Das Beispiel beschreibt ein privates Projekt. Prüfen Sie die vier Gruppen getrennt: Ein Paket in mehreren Gruppen ist nicht automatisch überflüssig.

Warum diesen package.json-Editor verwenden?

Bedeutungsvolle Reihenfolgen erhalten

Der package.json-Editor sortiert nur innerhalb von dependencies, devDependencies, peerDependencies und optionalDependencies. Die Reihenfolge von scripts, exports und den obersten Feldern bleibt erhalten. Bedingungen bekommen dadurch keine andere Priorität.

Vier Abhängigkeitsgruppen werden intern sortiert; die Exportzweige daneben bleiben unverändert.

Änderungen vor dem Ersetzen prüfen

Das Ergebnis bleibt zunächst eine eigene Vorschau. Übernehmen, Beispiel laden und Leeren zeigen Inhalt und Zeichenzahl der Ersetzung. Einmaliges Rückgängigmachen stellt Eingabe und Ergebnis samt ihrem vorherigen Zustand wieder her.

Ein ursprüngliches Manifest und seine Vorschau mit Pfeilen für Übernehmen und Rückgängigmachen.

Von der Prüfung zur bewussten Übernahme

01

Automatik bei Bedarf ausschalten

Die Prüfung startet 350 ms nach der letzten Änderung. Ohne Automatik erscheint die Hauptschaltfläche; Strg oder Cmd plus Enter führt dieselbe Prüfung aus. Änderungen sperren sofort den Export alter Ergebnisse.

02

Geänderte Gruppen zählen

Die Sortiervorschau meldet, wie viele Gruppen tatsächlich eine neue Reihenfolge haben. Die Option für die ursprüngliche Reihenfolge formatiert wieder die Eingabe. Versionswerte werden weder aktualisiert noch in andere Gruppen verschoben.

03

Ergebnis vergleichen und übernehmen

Kopieren und Herunterladen funktionieren auch vor dem Übernehmen. Zum Ersetzen der Eingabe bestätigen Sie die Vorschau. Rückgängig stellt den vorherigen Gesamtzustand her, auch wenn das alte Ergebnis ungültig oder veraltet war.

Syntax, Paketnamen und Felder prüfen

Fehler an der ursprünglichen Stelle

Wenn Sie package.json validieren, werden Kommentare, abschließende Kommas, doppelte Schlüssel und andere Wurzeltypen abgelehnt. Zeile, Spalte und JSON Pointer beziehen sich auf die Eingabe, nicht auf neu formatierten Text.

npm Paketname und Version getrennt prüfen

Für das Feld name gelten die Regeln für neue Pakete, für Abhängigkeiten die Regeln für bestehende Namen. Eine angegebene version prüft node-semver; fehlende Identitätsfelder sind für lokale Projekte zulässig.

Abhängigkeiten gruppenweise lesen

Die Übersicht zeigt Namen und unveränderte Versionsangaben in vier Gruppen, jeweils 100 Zeilen auf einmal. Feldhilfen erklären Laufzeit-, Entwicklungs-, Peer- und optionale Abhängigkeiten. Änderungen erfolgen im JSON-Text.

Einrückung auswählen

Sie können package.json bearbeiten und mit zwei Leerzeichen, vier Leerzeichen oder Tabs formatieren. Eigene Felder und die Schreibweise von Zahlen bleiben erhalten. Die Ergebnisdatei heißt package.json.

Grenzen der lokalen Prüfung

Umfang des eingebauten Schemas
Das abgeleitete SchemaStore-Schema prüft die Manifeststruktur; private muss ein boolescher Wert sein. Externe Werkzeugkonfigurationen wie ESLint und Prettier bleiben ungeprüft erhalten. Ein $schema in der Eingabe wird nicht abgerufen.
Keine Aussage zur Installierbarkeit
Bereiche, Tags, Git-URLs, lokale Pfade, Aliasse und workspace-Angaben bleiben Zeichenketten. Existenz, Aktualität und Sicherheit einer Version sowie die tatsächliche Auflösung werden nicht geprüft.
Keine Befehle ausführen
Skripte sind Text. Das Werkzeug installiert nichts, veröffentlicht kein Paket und verändert weder Lockdateien noch andere Workspace-Dateien. Ein positives Ergebnis bestätigt keine Veröffentlichungsreife.
Sortierung nur innerhalb der Gruppen
Abhängigkeiten werden nicht zwischen Gruppen verschoben oder gruppenübergreifend entfernt. exports, imports, Arrays und scripts behalten ihre Reihenfolge. Escape-Schreibweisen von Zeichenketten können sich beim Formatieren ändern.
Begrenzte Eingabe
Ein JSON-Objekt mit höchstens 100.000 UTF-16-Codeeinheiten und 100 Verschachtelungsebenen. Unsichere Ganzzahlen und Zahlenüberläufe werden abgelehnt. Es erscheinen höchstens 50 Diagnosen; ungültige oder veraltete Ergebnisse bleiben für den Export gesperrt.

Fragen zum package.json-Editor

Wie lassen sich Kommentare in package.json einfügen?

Standard-JSON erlaubt keine Zeilen- oder Blockkommentare. Das Werkzeug meldet sie als Fehler, statt sie still zu entfernen. Eigene Metadatenfelder für Notizen sind normale Daten; prüfen Sie deren Verträglichkeit mit Ihren übrigen Werkzeugen.

Was unterscheidet dependencies, devDependencies und peerDependencies?

dependencies enthält Laufzeitpakete, devDependencies Werkzeuge für Entwicklung und Tests. peerDependencies beschreibt Erwartungen an die Umgebung des Verbrauchers. optionalDependencies erlaubt fehlgeschlagene Installationen. Die Gruppenzuordnung wird nicht automatisch geändert.

Kann ich die Abhängigkeiten in package.json alphabetisch sortieren, ohne ein Paket zu installieren?

Ja. Die Vorschau sortiert die Namen der vier Abhängigkeitsgruppen im Browser, ohne ein zusätzliches Paket zu installieren. Prüfen Sie Gruppenanzahl und Ergebnis. Skripte und bedingte Exporte werden dabei nicht umgeordnet.

Warum entspricht der name in package.json nicht dem erwarteten Muster?

Neue Namen müssen unter anderem klein geschrieben, URL-tauglich und einschließlich Scope höchstens 214 Zeichen lang sein. @team/widget wird unterstützt. Eine gültige Schreibweise prüft weder Verfügbarkeit noch Eigentum im Register.

Was ist der Unterschied zwischen ~ und ^ in package.json?

Bei üblichen Hauptversionen größer null erlaubt ~1.2.3 vor allem Patchupdates, ^1.2.3 zusätzlich kompatible Minorupdates. Für Hauptversion null und Vorabversionen gelten weitere Regeln. Hier bleibt die Angabe unverändert; eine installierte Version wird nicht ermittelt.

Welche Felder braucht eine minimale package.json?

Für Projekte ohne Veröffentlichung erlaubt npm das Weglassen von name und version. Deshalb besteht auch ein leeres Objekt diese lokale Strukturprüfung. Zur Veröffentlichung sind zusätzliche Angaben und Prüfungen erforderlich.

Fehlt eine hilfreiche Prüfung?

Die nächste Änderung prüfen

Starten Sie im package.json-Editor mit einem kleinen Beispiel und vergleichen Sie die Abhängigkeitsgruppen, bevor Sie das Ergebnis übernehmen.