Startseite › Entwickler-Tools › Python Formatter

Python Formatter

Füge unordentlichen Python-Code ein und erhalte sauberen, einheitlich formatierten Code im Stil von Black und Ruff: vereinheitlichte Abstände und Anführungszeichen, zwei Leerzeilen um Funktionen und Klassen auf oberster Ebene und lange Zeilen, die an Klammern umbrochen werden. Wähle Zeilenlänge, Anführungszeichen und Einrückung.

Zuletzt aktualisiert:

Anzeige
Anzeige

Anleitung: Python Formatter

  1. Füge deinen Python-Code in das linke Feld ein, lade eine .py-Datei hoch oder klicke auf Beispiel.
  2. Wähle die Optionen: Zeilenlänge (88 ist der Standard von Black und Ruff), Anführungszeichen und Einrückungsbreite.
  3. Lies das Ergebnis rechts ab; es aktualisiert sich beim Tippen, und die Statuszeile zeigt, wie viele Zeilen sich geändert haben.
  4. Behebe Syntaxfehler, falls der Formatter einen meldet, etwa eine nicht geschlossene Klammer oder einen offenen String.
  5. Kopiere oder lade den formatierten Code als .py-Datei herunter.

Was der Formatter ändert

VorherNachherRegel
x=1+2*yx = 1 + 2 * yLeerzeichen um Zuweisungen und binäre Operatoren
f(a , b ,c)f(a, b, c)Kein Leerzeichen vor einem Komma, eines danach
def f(a = 1, *args, b : int=2)def f(a=1, *args, b: int = 2)Keine Leerzeichen um Standardwerte von Schlüsselwortargumenten, außer bei Annotation
x ** 2, f(x)**2x**2, f(x) ** 2Potenzoperator ohne Leerzeichen nur bei einfachen Operanden
ham[lower+offset:upper]ham[lower + offset : upper]Slice-Doppelpunkte verhalten sich wie Operatoren, wenn ein Operand komplex ist
'Text', u'x', 0XFF, 1E5"Text", "x", 0xFF, 1e5Bevorzugte Anführungszeichen sowie vereinheitlichte Präfixe und Zahlen
if x: return yif x: / return y in eigener ZeileEine Anweisung pro Zeile
x = 1 # Notizx = 1 # NotizZwei Leerzeichen vor einem Inline-Kommentar, eines nach #
class A():class A:Überflüssige Klammern entfernt

Wie lange Zeilen umbrochen werden

Ist eine Zeile länger als das Limit, versucht der Formatter zuerst, an der letzten öffnenden Klammer zu trennen: Der Inhalt kommt in eine eigene eingerückte Zeile, und die schließende Klammer kehrt zur ursprünglichen Einrückung zurück. Passt der Inhalt immer noch nicht, wird am Trennzeichen mit der höchsten Priorität getrennt: zuerst Kommas (ein Element pro Zeile, mit hinzugefügtem abschließendem Komma), dann Comprehension-Klauseln, bedingte Ausdrücke, and/or, Vergleiche und arithmetische Operatoren, wobei jeder Operator eine neue Zeile beginnt. Lange rechte Seiten von Zuweisungen und return-Anweisungen werden in Klammern gesetzt, sodass keine Backslashes nötig sind.

result = load_config("settings.env", defaults={"mode": "production", "debug": "false"}, strict=True)

# becomes (line length 88)
result = load_config(
    "settings.env", defaults={"mode": "production", "debug": "false"}, strict=True
)

Denselben Stil im eigenen Projekt verwenden

  • Installiere einen Formatter mit pip install black oder pip install ruff und führe black . oder ruff format . in deinem Projektordner aus.
  • Lege die Zeilenlänge einmal in pyproject.toml fest: [tool.black] line-length = 100 oder [tool.ruff] line-length = 100.
  • Verwende quote-style = "single" unter [tool.ruff.format], wenn dein Team einfache Anführungszeichen bevorzugt; Black selbst unterstützt nur doppelte Anführungszeichen (oder lässt sie mit --skip-string-normalization unverändert).
  • Füge den Formatter zu einem Pre-Commit-Hook oder zur Formatierung beim Speichern in deinem Editor hinzu, damit der Code ohne Handarbeit einheitlich bleibt.

Häufige Fragen

Welchen Stil verwendet dieser Python Formatter?

Er folgt dem Code-Stil von Black, den auch der Formatter von Ruff umsetzt: Einrückung mit 4 Leerzeichen, doppelte Anführungszeichen, Leerzeichen um Operatoren und nach Kommas, zwei Leerzeilen um Funktionen und Klassen auf oberster Ebene und Zeilenumbruch bei 88 Zeichen innerhalb von Klammern. Hier formatierter Code entspricht in den allermeisten Fällen dem, was black oder ruff format erzeugen würden.

Was ist der Unterschied zwischen Black und Ruff format?

Black ist der ursprüngliche, meinungsstarke Python-Formatter, geschrieben in Python. Ruff ist ein viel schnellerer Linter und Formatter, geschrieben in Rust, dessen Formatter als direkter Ersatz für Black konzipiert ist und nahezu identische Ausgaben erzeugt. Diese Seite nutzt nach WebAssembly kompiliertes Ruff, wenn es geladen werden kann, und sonst einen integrierten JavaScript-Formatter, der dieselben Regeln anwendet.

Was ist ein Magic Trailing Comma?

Endet eine Sammlung oder Argumentliste mit einem Komma, wie in foo(a, b,), halten Black und Ruff sie mit einem Element pro Zeile aufgeklappt, selbst wenn sie in eine Zeile passen würde. So kannst du das vertikale Layout für Listen wählen, die sich oft ändern. Deaktiviere die Option, um solche Listen zusammenzuklappen, wenn sie passen.

Verändert das Formatieren, was mein Code tut?

Nein. Formatter ändern nur Leerraum, Zeilenumbrüche, überflüssige Klammern, Anführungszeichen und die Groß-/Kleinschreibung von Zahlenpräfixen, daher bleibt der Syntaxbaum des Programms gleich. Black prüft das, indem es den AST vor und nach dem Formatieren vergleicht, und die integrierte Engine hier wurde auf dieselbe Weise mit der Python-Standardbibliothek getestet.

Warum wird eine lange Zeile nicht umbrochen?

Zeilen werden nur an Klammern, Operatoren und Kommas umbrochen. Ein einzelner langer String, ein langer Kommentar oder ein langer Name lässt sich nicht trennen, ohne den Code zu ändern, daher lässt der Formatter ihn unverändert. Brich lange Strings selbst mit impliziter Verkettung innerhalb von Klammern um.

Ist das Ergebnis PEP-8-konform?

Die Ausgabe folgt PEP 8 bei Einrückung, Leerraum und Leerzeilen. Die Standard-Zeilenlänge von Black ist 88 statt 79 wie bei PEP 8; wähle 79 in den Optionen, wenn dein Projekt das verlangt.

Wird mein Code hochgeladen?

Nein. Das Formatieren läuft vollständig in deinem Browser, entweder mit dem Ruff-WebAssembly-Modul oder der integrierten Engine, sodass privater Code nie dein Gerät verlässt.

Werden alle Tools auf FreeToolCabin auf Qualität und Genauigkeit getestet?

Ja. Jedes Tool auf der Website durchläuft automatische Tests in echten Browsern, die prüfen, ob das Ergebnis stimmt und keine Fehler auftreten. Wenn du einen Fehler findest oder einen Vorschlag hast, schreib uns an [email protected] – wir sehen es uns an.

Ähnliche Tools

Alle Code-Formatierer & Validatoren ansehen →