CLI-Fehlerbehebung
Behebe Probleme mit Dateiauswahl, Basisstand, Ergebnisabruf und Katalog, ohne vorher nützliche Zustandsdaten zu löschen.
Halte für die Fehlerdiagnose die installierte Version, den Befehl, das Arbeitsverzeichnis, die Fehlermeldung und die betroffenen Pfade bereit. Entferne Zugangsdaten, bevor du Protokolle teilst: Diagnoseausgaben beim Start und bei Fehlern können argv im Rohformat enthalten.
Keine Quelldateien passen zu #
Suche die nächstgelegene .lingo/config.json. Ein Befehl, der aus einem Unterverzeichnis ausgeführt wird, kann das Projekt eines übergeordneten Verzeichnisses verwenden. Kontrolliere zuerst include und dann pattern, da selbst eine leere Einschlussregel diese Einstellung überschreibt. Ausschlüsse gelten für den jeweiligen Eintrag; ein anderer Eintrag kann dieselbe Datei weiterhin auswählen.
Verwende eine unterstützte Matcher-Syntax wie docs/en/**/*, setze Shell-Muster in Anführungszeichen und achte darauf, welche Dateiendungen unterstützt werden. YAML erfordert ausdrücklich yaml, yaml-root-key oder yaml-openapi; Android XML erfordert android. Für eine .txt-, .csv- oder .properties-Datei brauchst du ein Muster, das mit der jeweiligen Dateiendung endet, oder "format": "txt", "format": "csv" oder "format": "properties". Bei einem allgemeinen Muster wie docs/en/**/* wird sie übersprungen; bei einem txt-, csv- oder properties-Eintrag werden alle Dateien ohne die entsprechende Endung übersprungen. Auch ein ausdrücklich angegebenes Format lässt nicht jede Dateiendung zu.
Die Ausgabe ist am falschen Ort gelandet #
Lies die Warnungen zur Pfadableitung und gleiche den Zielpfad mit dem Loader deiner Anwendung ab. Wenn kein Pfadsegment für die Ausgangssprache erkannt wird, definiere targetPath und sourceRoot, statt dich auf die Ausweichlösung mit eingefügter Sprache zu verlassen. Halte Zieldateien außerhalb der Quelldateisuche und sieh dir mögliche Kollisionen an.
Das Verschieben von Dateien allein aktualisiert den Basisstand nicht. XCStrings verwendet bewusst einen gemeinsamen Quellkatalog und keine gewöhnliche Dateistruktur mit separaten Dateien pro Sprache. Siehe Ausgabepfade.
Eine Option hat keine Wirkung #
Unbekannte Schlüssel auf Stamm- oder Dateiebene lösen Warnungen aus und werden ignoriert. Kontrolliere die Schreibweise und welche Optionen der ausgewählte Handler tatsächlich unterstützt. Einstellungen für Katalogpfade aktualisieren keine Push-Muster. extract und check verwenden jeweils unabhängig voneinander en als Standard für die Ausgangssprache.
Die lokale Qualitätsbewertung verwendet die ausführbare Datei lingo.config.ts, nicht die JSON-Datei des Projekts. Eine Schutzoption für JSON wirkt sich nicht unbedingt auf Markdown oder ein anderes Format aus.
Ein Artefakt des Basisstands fehlt #
Das vorherige Quellartefakt, auf das der Hash im Lockfile verweist, muss lokal oder auf dem Server vorhanden sein. Sieh dir den genannten Eintrag an und stelle nachweislich korrekte Bytes oder einen konsistenten Basisstand wieder her. Erfinde keinen Hash und lösche nicht das gesamte Lockfile, um den Fehler zu verbergen.
Fehlen Zustandsdaten, speichert ein einfacher erster Push die Quellbytes; fehlende gewöhnliche Zieldateien müssen nachträglich generiert werden. Lockfile und Cache erklärt, welchen Datensatz der Vorgang benötigt.
Pull meldet einen Konflikt #
Führe lingo pull --dry-run aus, um zu sehen, welche Schreibvorgänge vorgesehen sind. Eine Zieldatei, die von der Serverausgabe, den beim Push erfassten Bytes und dem Hash im Lockfile abweicht, blockiert Schreibvorgänge. Ein Commit dieser Datei ändert nichts am Vergleich.
Bewahre die Änderung und gleiche sie ab, stelle eine bekannte Version wieder her oder verwende force nur, wenn du die Datei bewusst ersetzen möchtest. Bearbeite Zieldateien nicht während push --wait, da dabei die erneute Konfliktkontrolle von pull fehlt.
Die Verarbeitung ist fehlgeschlagen oder bleibt unvollständig #
Sieh dir die Fehler für jedes Ziel an und unterscheide zwischen ausstehender Verarbeitung, Prüfung, Fehlern und fehlenden Ausgaben. Bei einer fehlgeschlagenen Ausführung schreiben push --wait und pull zunächst die fertiggestellten Dokumente und beenden sich dann mit einem Exit-Code ungleich null. Kontrolliere den Zustand und die tatsächlich vorhandenen Dateien.
Wenn alle noch nicht fertiggestellten Ziele auf eine menschliche Prüfung warten, beenden push --wait und pull das Warten und melden dies. Dokumente, bei denen alle Sprachen fertig sind, können abgerufen werden. Führe lingo pull erneut aus, sobald die Prüfer fertig sind. Ein weiterer Push beendet das Warten auf eine Prüfung nicht.
Wenn die Ausführung fehlgeschlagen ist, behebe die gemeldete Ursache und wiederhole den für die jeweilige Verarbeitung passenden Befehl. Verwende für gewöhnliche Quellaktualisierungen lingo push --wait mit unveränderter Quelle und beibehaltenem Basisstand. Wiederhole bei fehlenden Zieldateien die nachträgliche Generierung erst, wenn die vorhandenen Zieldateien auf dem aktuellen Stand sind. Gehe dabei wie unter Eine Sprache hinzufügen beschrieben vor. Um lediglich einen weiteren Versuch anzufordern, sind weder eine Quelländerung noch ein force-Flag oder das Löschen von Zustandsdaten nötig.
Push gibt die ID des Jobs aus, den es einreicht oder mit dem es sich erneut verbindet. Wenn die Ergebnisse des früheren Push noch nicht abgerufen wurden und die Anfrage unverändert ist, verwendet push diese Anfrage erneut: Ein noch laufender Job behält seine ID, ein fehlgeschlagener wird durch einen neuen Job ersetzt. Bewahre die ID des fehlgeschlagenen Jobs auf und vergewissere dich, dass die nächste ausgegebene Job-Zeile eine andere ID enthält. Das zeigt eine neue Einreichung an, nicht eine erfolgreiche Übersetzung: Sieh dir die Ergebnisse der einzelnen Ziele an, rufe die Ausgabe ab und führe eine Prüfung des Diffs durch. Lass lokale Zieldateien während --wait unverändert. Wenn lokale Änderungen geschützt werden müssen, führe push und pull getrennt aus und nutze dabei die Konfliktkontrolle von pull.
Wenn dein installierter Client denselben fehlgeschlagenen Job zurückgibt, reiche ihn nicht wiederholt ein, sondern sende eine E-Mail an support@lingo.dev. Gib die CLI-Version, den um vertrauliche Angaben bereinigten Befehl, die alten und zurückgegebenen Ausführungs-IDs, die Quellrevision, die betroffenen Sprachen und Pfade, Zeitstempel und die bereinigte Fehlermeldung an. Nimm keine Zugangsdaten, privaten Quelltexte oder unbearbeiteten Dateien mit Zugangsdaten in die Nachricht auf. Behalte den lokalen Ausführungsverweis und das Lockfile bei, während der Fehler untersucht wird.
Das Löschen des Ausführungsverweises ist keine zuverlässige Methode, um eine neue Übersetzung anzufordern. Solange die Ergebnisse eines Push noch nicht abgerufen wurden, enthält der Verweis die Anfrageidentität, die doppelte Einreichungen verhindert. Wenn keine Ausführung gefunden wird, kontrolliere den Rechner, den absoluten Projektstammpfad und ob ein anderer Push den Verweis ersetzt hat.
Katalogkontrollen schlagen fehl #
Führe extract mit derselben Sprache und denselben Pfaden wie check aus. Sieh dir Warnungen zu dynamischen oder destrukturierten Aufrufen an, bevor du verwaiste Einträge entfernst. Eine fehlende Zieldatei wird nur gemeldet, wenn die files-Muster zum Quellkatalog passen. Vergleiche andernfalls die erwarteten Sprachen mit den vorhandenen Dateien.
Bereinige nur beabsichtigte Entfernungen, generiere die Deklarationen neu und führe anschließend check und den Build der Anwendung aus. status wurde nach check verlagert; interne Dienstnamen sind keine ausführbaren Befehle.
Bevor du etwas löschst #
Purge zeigt eine Vorschau der zu löschenden Zieldateien. Datei- und Sprachfilter beschränken das Löschen auf ausgewählte Zieldateien und deren Lockfile-Einträge; ein ungefilterter purge entfernt das gesamte Lockfile. Gemeinsam genutzte XCStrings-Kataloge werden übersprungen. Verwende purge, wenn du tatsächlich Dateien löschen möchtest. Für die meisten Wiederherstellungsaufgaben genügt eine gezielte Korrektur, bei der akzeptierte Formulierungen und wiederherstellbare Zustandsdaten erhalten bleiben.