Direkte Antwort
Welche Befehlszeilenfunktionen unterstützt Diff Anything?
Unter Windows verwendet Diff Anything die ausführbare Datei der Desktop-App mit --cli und zwei Quellpfaden oder mit den Argumenten, die Git an einen Diff-Treiber übergibt. Einzelvergleiche unterstützen auto, text, json, yaml, toml, ini, plist, xml, csv, env, http, api, notebook, sqlite, folder, archive, document und binary. Die kostenlose Befehlszeile vergleicht Text, JSON und Notebooks; die übrigen Vergleichstypen benötigen Pro. Dazu kommen Text-Ignorierregeln, summary-, terminal- oder JSON-Ausgabe, Optionen für Farbe, Sprache und Kontext sowie ein optionaler Exit-Code für Unterschiede. --fail-on breaking berücksichtigt nur inkompatible oder nicht klassifizierte API-Schemaänderungen. Pro unterstützt Batch-Manifeste in YAML oder JSON, eine failOn-Einstellung pro Fall und summary-, JSON-, JUnit- oder SARIF-Ausgabe. Pro ergänzt außerdem Berichte, --apply-patch, den Git-Merge-Treiber und das Merge-Tool.
Einzelvergleiche
Jede Einzelvergleichsoption, ohne implizite Flags.
Verwenden Sie --mode auto|text|json|yaml|toml|ini|plist|xml|csv|env|http|api|notebook|sqlite|folder|archive|document|binary und --format summary|terminal|json. Ein Terminal verwendet standardmäßig die Terminalausgabe. Die umgeleitete Standardausgabe ist standardmäßig auf die Zusammenfassung eingestellt.
Verwenden Sie --color auto|always|never, --language LANGUAGE und --context LINES. --language auto stellt die automatische Spracherkennung wieder her. Der Kontext darf nicht negativ sein; standardmäßig werden drei Zeilen angezeigt.
Text- und Dokumentvergleiche erfordern --ignore-text und --ignore-lines mit einem regulären Ausdruck, --ignore-preset für integrierte Zeitstempel- und ID-Muster, --ignore-comments, --ignore-columns und --align LEFT:RIGHT. --encoding, --left-encoding und --right-encoding lesen Dateien in einer ausgewählten Kodierung.
- --exit-code: 0 sauber, 1 unterschiedlich, 2 ungültige Eingabe oder Vergleichsfehler
- --fail-on breaking: mit --mode api, 1 nur für Breaking oder nicht klassifizierte API-Schemaänderungen
- Ohne --exit-code oder --fail-on beendet ein gültiger geänderter Einzelvergleich 0
- Verwenden Sie -- vor Pfaden, wenn ein Dateiname mit einem Bindestrich beginnt
- --help, --version und --integration-help sind verfügbar
PDF-Layout
Direkter PDF-Layoutvergleich ist Desktop; gerenderte Bilder machen es automatisierbar.
Der Dokumentmodus CLI vergleicht extrahierte Dokumentinhalte. Der visuelle Diff PDF der gerenderten Seite und sein Übereinstimmungsprozentsatz pro Seite sind Teil des Desktop-Dokumentarbeitsbereichs und nicht das Ergebnis des direkten Dokuments CLI.
Um ein PDF-Layout automatisiert zu prüfen, rendern Sie die entsprechenden Referenz- und Vergleichsseiten als gleich große Bilder. Vergleichen Sie jedes Bildpaar mit Pro über --mode binary --format json und lesen Sie die Bildähnlichkeit und die Anzahl geänderter Pixel aus. Ein Ähnlichkeitsschwellenwert bewertet nur die gerenderte Darstellung. Er belegt nicht, dass Wortlaut, Tags, Barrierefreiheit oder Druckverhalten übereinstimmen.
- Desktop PDF: Wählen Sie „Visual Diff“ für gerenderte Seiten
- CLI Wortlaut: --mode document vergleicht extrahierten Inhalt
- CLI-Layoutschleife: Rendern Sie zuerst die Seiten und vergleichen Sie dann jedes Bildpaar im Pro-Binärmodus
Charge und CI
Das Batch-Verhalten ist explizit und nur Pro.
Ein Batch-Manifest kann YAML oder JSON sein. Sein Stamm kann ein Objekt mit einem Vergleichsarray oder einem Array der obersten Ebene sein. Jedes Element akzeptiert Name, Left, Right, einen optionalen unterstützten Modus und failOn: any (Standard) oder break für API-Schemafälle.
Batch-Ausgabeformate sind Zusammenfassung, JSON, JUnit und SARIF, geschrieben in stdout oder, mit --output FILE, in eine UTF-8-Datei. Batch gibt 0 zurück, wenn jeder Fall die FailOn-Prüfung besteht, 1, wenn ein Fall die Prüfung nicht besteht oder nicht verglichen werden konnte, und 2, wenn der Aufruf oder das Laden des Manifests fehlschlägt.
- JUnit zeichnet fehlgeschlagene Fälle als Testfehler auf und listet API-Ergebnisse mit ihren Regelcodes auf
- SARIF 2.1.0 meldet jedes API-Ergebnis als eigenes Ergebnis: Brechende Änderungen unter ihrem Regelcode als Fehler
- Desktop-Profile und ihre semantischen Regeln sind keine Batch-Manifest-Optionen
Kostenlos und Pro
Desktop-Vorschauen und CLI-Modi haben unterschiedliche freie Grenzen.
Bei kostenloser Desktop-Nutzung kann jede Vergleichs-Engine für Dateien mit bis zu 5 MiB pro Seite und 10 neue Vergleichssitzungen pro lokalem Tag in der Vorschau angezeigt werden. Sammlungen zeigen die ersten 100 Elemente und PDFs zeigen die ersten drei Seitenvorschauen. Der kostenlose CLI unterstützt nur Text, JSON und Notebooks.
Der einmalige Kauf von Pro schaltet jeden anderen CLI-Modus, jedes Batch-Manifest, --report, --apply-patch, den Zusammenführungstreiber und das Zusammenführungstool, größere Quellen innerhalb technischer Grenzen, Berichtsexport, Profile und Verlauf, Drei-Wege-Zusammenführung, Ordnersynchronisierung und vertrauenswürdige Präprozessoren frei.
Am besten für
Wo dieser Workflow passt.
- Syntaxhervorgehobene Dateiunterschiede in einem Terminal lesen
- Verwendung von Diff Anything als Git-Difftool oder als Diff-Treiber für ausgewählte Dateitypen
- Das Ausführen wiederholbarer Pro-Vergleichsmanifeste erfolgt in CI
Keine Konten, Cloud-Vergleichsdienst, Analysen oder Telemetrie.
Relevante Fähigkeiten
Was Diff Anything für den Job bringt.
Praktischer Arbeitsablauf
Vom Setup zum überprüften Ergebnis.
Rufen Sie den CLI-Modus auf
Führen Sie die installierte ausführbare Desktop-Datei mit --cli, beliebigen Optionen und genau zwei lesbaren Quellpfaden aus.
Wählen Sie Modus und Ausgabe
Verwenden Sie die automatische Erkennung oder einen explizit unterstützten Modus und wählen Sie dann Terminal, Zusammenfassung oder JSON-Ausgabe für eine Person oder ein anderes Programm aus.
Prozessverhalten festlegen
Fügen Sie --exit-code hinzu, wenn ein Unterschied 1 zurückgeben soll, oder --fail-on breaking für eine API-Schemaprüfung; Ungültige Eingabe- und Vergleichsfehler geben 2 zurück.
Sicher integrieren
Konfigurieren Sie ein Git-Difftool oder einen Diff-Treiber ohne --exit-code oder verwenden Sie ein Pro-Batch-Manifest für die Zusammenfassung, JSON-, JUnit- oder SARIF CI-Ausgabe.
Nützlich in der Praxis
Direkte Antworten
Fragen zum CLI-Diff-Tool.
Welche Befehlszeilenfunktionen unterstützt Diff Anything?
Unter Windows verwendet Diff Anything die ausführbare Datei der Desktop-App mit --cli und zwei Quellpfaden oder mit den Argumenten, die Git an einen Diff-Treiber übergibt. Einzelvergleiche unterstützen auto, text, json, yaml, toml, ini, plist, xml, csv, env, http, api, notebook, sqlite, folder, archive, document und binary. Die kostenlose Befehlszeile vergleicht Text, JSON und Notebooks; die übrigen Vergleichstypen benötigen Pro. Dazu kommen Text-Ignorierregeln, summary-, terminal- oder JSON-Ausgabe, Optionen für Farbe, Sprache und Kontext sowie ein optionaler Exit-Code für Unterschiede. --fail-on breaking berücksichtigt nur inkompatible oder nicht klassifizierte API-Schemaänderungen. Pro unterstützt Batch-Manifeste in YAML oder JSON, eine failOn-Einstellung pro Fall und summary-, JSON-, JUnit- oder SARIF-Ausgabe. Pro ergänzt außerdem Berichte, --apply-patch, den Git-Merge-Treiber und das Merge-Tool.
Verfügt Diff Anything über einen separaten Bild-CLI-Modus?
Nein. Die dokumentierte CLI-Modusliste enthält keinen Bildmodus. Bilddateien können weiterhin durch unterstützte automatische oder binäre Verarbeitung überprüft werden, während der speziell entwickelte visuelle Bildarbeitsbereich eine Desktop-Funktion ist.
Vergleicht der CLI-Dokumentmodus PDF-Seiten visuell?
Nein. Der Dokumentmodus CLI vergleicht extrahierte Inhalte. Rendern Sie für automatisierte Layoutprüfungen zunächst die entsprechenden PDF-Seiten in Bilder gleicher Größe und verwenden Sie den Pro-Binärmodus mit der JSON-Ausgabe. Für einen direkten gerenderten PDF-zu-PDF-Vergleich verwenden Sie den visuellen Desktop-Diff.
Sollte ein Git-Difftool-Befehl --exit-code verwenden?
Nein. Git ruft bereits ein Difftool für ein geändertes Paar auf und erwartet eine erfolgreiche Verarbeitung, daher lässt der dokumentierte Difftool-Befehl --exit-code aus. Lassen Sie es auch bei einem Diff-Treiber weg: Git stoppt git diff bei der ersten geänderten Datei, wenn ein Diff-Treiber mit einem Status ungleich Null beendet wird.
Kann Diff Anything als Diff-Treiber für Git Diff laufen?
Ja, auf Windows. Definieren Sie den Treiber mit git config diff.diff-anything.command und weisen Sie ihn Dateitypen in .gitattributes zu, zum Beispiel *.json diff=diff-anything. git diff verwendet es dann für diese Dateien; git log -p und git show verwenden es mit --ext-diff. Beim kostenlosen Plan wird eine Datei, die der Plan nicht abdeckt, als nicht verglichen aufgeführt und git diff wird fortgesetzt.
Wo ist die ausführbare Datei installiert?
Die Microsoft Store-Version auf Windows deklariert den Ausführungsalias diff-anything.exe. Die Mac App Store-Version läuft in der App Sandbox von Apple, die sie auf Dateien und Ordner beschränkt, die Sie in der App auswählen. Daher wird die Verwendung der Befehlszeile für Windows beschrieben.
Gehen Sie tiefer
Unter Windows Vergleiche wiederholbar ausführen, Exit-Codes verstehen, Git einbinden und maschinenlesbare Ergebnisse für CI erzeugen.
Verwenden Sie Diff Anything aus der CLI, Git und CIKostenlos & Pro: Was ist enthalten
Verfügbar im Mac App Store und Microsoft Store. Mit der kostenlosen Desktop-Nutzung können Sie jede Vergleichs-Engine für Dateien bis zu 5 MiB pro Seite und 10 neue Vergleichssitzungen pro lokalem Tag ausprobieren; Sammlungsvorschauen zeigen die ersten 100 Elemente, binäre Vergleiche die ersten 100 Byte-Unterschiede und PDF-Vorschauen die ersten drei Seiten. Der Nur-Text-, JSON- und Jupyter-Notebook-Vergleich ist vollständig und das Öffnen von Dateien über den Finder oder den Datei-Explorer, diffanything://-Links und AppleScript ist kostenlos. Die kostenlose CLI unterstützt Text, JSON und Notebooks. Durch einen einmaligen Pro-Kauf werden die Vorschau- und Sitzungsbeschränkungen aufgehoben und größere Quellen innerhalb technischer Grenzen, gespeicherte Profile und Verlauf, Speichern von Ordner-Snapshots, Exportieren und Drucken von Berichten, JSON-Patch-Export, Anwenden von Patches, Drei-Wege-Zusammenführung und Konfliktlösung, der Git-Merge-Treiber und das Merge-Tool, Ordnersynchronisierung, Batch-Manifeste, vertrauenswürdige Präprozessoren und alle CLI-Modi freigeschaltet.