Bild in Base64 umwandeln: Ergebnis verstehen und richtig nutzen

Inhalt
Manchmal möchten Sie ein Bild nicht als Datei, sondern direkt als Zeichenkette in HTML oder CSS einbinden. Oder Sie haben irgendwoher einen Base64-String erhalten und möchten daraus wieder eine Bilddatei machen.
Dabei hakt es meist an denselben Stellen: Warum ist die Zeichenkette länger als das Original? Was bedeutet das Präfix "data:image/png;base64,"? Und warum wird das eingefügte Bild nicht richtig angezeigt?
Base64 ist kein Komprimierungsverfahren, sondern eine Schreibweise, mit der Binärdaten als Text dargestellt werden.
Dieser Artikel erklärt der Reihe nach, wie diese Schreibweise funktioniert, warum das Ergebnis größer ausfällt als das Original und wann Sie welches der beiden Ausgabeformate verwenden sollten.
Zusammenfassung ① Base64 teilt 8-Bit-Binärdaten in 6-Bit-Blöcke auf und stellt sie mit 64 Zeichen dar. Deshalb ist das Ergebnis etwa 33 % größer als das Original. ② Eine „Data-URL" trägt das Präfix data:MIME-Typ;base64, und lässt sich direkt in HTML/CSS verwenden. „Plain Base64" enthält ohne dieses Präfix nur den reinen codierten Wert. ③ Wenn Sie nur den Plain-Base64-Wert ohne Präfix in ein img-Tag einfügen oder eine Zeichenkette mit Leerzeichen und Zeilenumbrüchen unverändert decodieren, wird das Bild fehlerhaft dargestellt oder es tritt ein Fehler auf.
Warum das Ergebnis verwirrt: ein typisches Szenario
Manchmal soll ein kleines Icon ohne separate Bilddatei komplett in das HTML eingebettet werden. Das kommt zum Beispiel bei E-Mail-Templates vor, in denen externe Bilder häufig blockiert werden, oder bei Widgets, die als einzelne Datei ausgeliefert werden müssen.
Dafür wandelt man das Bild in Base64 um und fügt die Zeichenkette direkt in <img src="..."> ein.
Problematisch wird es, wenn Sie das Ergebnis unverändert kopieren und einfügen, das Bild aber nicht erscheint. Umgekehrt kann es passieren, dass Sie einen Base64-String vom Server als Datei speichern möchten, aber nicht wissen, welche Dateiendung Sie vergeben sollen.
Die Formatinformation der Originaldatei steckt oft nicht in der Zeichenkette selbst. Und selbst wenn sie enthalten ist, nützt sie nichts, wenn man nicht weiß, wo sie hingehört. Beide Situationen lösen sich, sobald Sie das Prinzip der Codierung verstehen.
Das Prinzip ohne Tool selbst nachrechnen
Wie 6-Bit-Blöcke in Zeichen umgewandelt werden
Der Kern der Base64-Codierung: Binärdaten, die in 8-Bit-Einheiten gespeichert sind, werden neu in 6-Bit-Einheiten aufgeteilt. Jeder 6-Bit-Wert (0–63) wird einer fest definierten Tabelle mit 64 Zeichen zugeordnet (A–Z, a–z, 0–9, +, /).
Das kleinste gemeinsame Vielfache von 8 und 6 ist 24 Bit. Deshalb entstehen aus jeweils 3 Bytes (24 Bit) des Originals vier 6-Bit-Blöcke, also 4 Zeichen.
Ein Beispiel: Die Bytewerte der Zeichen „Man" sind M=77, a=97 und n=110. Aneinandergereiht ergibt das binär 24 Bit (010011010110000101101110).
Teilt man diese in vier 6-Bit-Blöcke, erhält man 19, 22, 5 und 46. In der Zeichentabelle entsprechen sie T, W, F und u. „Man" wird also zu „TWFu" codiert.
Warum die Datenmenge wächst: und was das Padding mit „=" bedeutet
Hier zeigt sich auch, warum die Datenmenge zunimmt. Aus 3 Bytes des Originals werden 4 Zeichen, und speichert man diese 4 Zeichen als Text, sind es wieder 4 Bytes.
Das Verhältnis von 3 zu 4 Bytes beträgt 4/3, also etwa das 1,333-Fache. Darauf beruht die Rechnung „Nach der Codierung ist die Datei etwa 33 % größer".
Lässt sich die Originalgröße nicht restlos durch 3 teilen, wird die letzte Stelle mit dem Zeichen „=" aufgefüllt. Bleibt 1 Byte übrig, folgt „==", bleiben 2 Bytes übrig, folgt ein einzelnes „=". So ist die Ausgabelänge immer ein Vielfaches von 4.
Im Terminal selbst umwandeln
Wenn Sie nicht von Hand rechnen, sondern direkt umwandeln möchten, können Sie einen Befehl nutzen, der im Betriebssystem enthalten ist. In einem Terminal unter macOS oder Linux geben Sie Folgendes ein:
base64 -i image.png
Die ausgegebene Zeichenkette ist Plain Base64. Kennen Sie den MIME-Typ der Datei, setzen Sie ein Präfix wie „data:image/png;base64," davor, und die Data-URL ist fertig.
Um eine Zeichenkette wieder in eine Datei zurückzuwandeln, hängen Sie an denselben Befehl die Option -d an.
Mit unserem Tool prüfen.
Wählen Sie eine Datei aus: Sie wird direkt im Browser in Base64 umgewandelt, nicht an einen Server übertragen und bis maximal 10 MB unterstützt.

Typische Stolperstellen beim Lesen des Ergebnisses
Data-URL und Plain Base64 enthalten denselben codierten Wert, werden aber je nach Präfix unterschiedlich eingesetzt.
| Merkmal | Data-URL | Plain Base64 |
|---|---|---|
| Form | data:image/png;base64,iVBORw0K... | iVBORw0K... (ohne Präfix) |
| Einsatzort | Stellen, an denen der Browser den Wert direkt interpretieren muss, etwa <img src=""> oder CSS background-image | Stellen, an denen nur der reine codierte Wert benötigt wird, etwa API-Request-Body oder Dateispeicherung |
| MIME-Typ-Information | Im Präfix enthalten, muss nicht separat übermittelt werden | Nicht in der Zeichenkette enthalten, muss separat angegeben werden |
Am häufigsten passieren drei Fehler.
Fehler 1: Einfügen in ein img-Tag ohne Präfix
Kopieren Sie nur den Plain-Base64-String und fügen ihn unverändert in <img src="..."> ein, kann der Browser ihn nicht interpretieren und zeigt lediglich ein Symbol für ein fehlerhaftes Bild an.
Im src-Attribut muss immer die vollständige Data-URL mit dem Präfix „data:Bild-MIME-Typ;base64," stehen.
Fehler 2: Beim Decodieren ist die ursprüngliche Dateiendung unbekannt
Wenn Sie nur einen Base64-String erhalten, scheint es keine Möglichkeit zu geben, das ursprüngliche Dateiformat herauszufinden.
Die meisten Dateiformate haben jedoch in den ersten Bytes eine charakteristische Signatur (Magic Number). Prüfen Sie die ersten Bytes des decodierten Ergebnisses, können Sie Formate wie PNG, JPEG, GIF oder PDF rückwirkend ableiten.
Allerdings gibt es eine Grenze: Bei Formaten ohne Signatur oder mit sich überschneidenden Signaturen lässt sich die genaue Dateiendung nicht bestimmen.
Fehler 3: Zeichenkette mit Leerzeichen und Zeilenumbrüchen unverändert decodieren
Die Base64-Zeichentabelle enthält weder Leerzeichen noch Zeilenumbrüche.
In manchen Systemen, etwa bei E-Mails, ist es üblich, lange Base64-Werte nach jeweils 76 Zeichen umzubrechen. Geben Sie eine Zeichenkette mit solchen Zeilenumbrüchen unverändert an eine Decodierfunktion, werden diese als ungültige Zeichen erkannt, und es kommt zu einem Fehler oder einem fehlerhaften Ergebnis.
Entfernen Sie vor dem Decodieren zuerst Leerzeichen und Zeilenumbrüche, lässt sich das Problem vermeiden.
Zusammenfassung
- Base64 teilt 8-Bit-Daten in 6-Bit-Blöcke auf und stellt sie mit 64 Zeichen dar. Durch diese Struktur ist das Ergebnis etwa 33 % (4/3-fach) größer als das Original.
- Ist die Originalgröße kein Vielfaches von 3 Bytes, wird mit dem Zeichen „=" aufgefüllt, sodass die Ausgabelänge ein Vielfaches von 4 ist.
- Mit dem Präfix „data:MIME-Typ;base64," heißt der Wert Data-URL, ohne Präfix ist es der reine codierte Wert, also Plain Base64. Beide haben unterschiedliche Einsatzzwecke.
- In ein img-Tag oder in CSS gehört die komplette Data-URL samt Präfix. Für Daten zum Speichern oder Übertragen verwenden Sie Plain Base64.
- Beim Lesen eines Decodierergebnisses leiten Sie das Format aus der Byte-Signatur am Anfang ab. Zeichenketten mit Leerzeichen und Zeilenumbrüchen müssen Sie vorher bereinigen, damit sie fehlerfrei interpretiert werden.
Wählen Sie eine Datei aus: Sie wird direkt im Browser in Base64 umgewandelt, nicht an einen Server übertragen und bis maximal 10 MB unterstützt.
Häufig gestellte Fragen
Wird eine Datei bei der Base64-Umwandlung immer genau 33 % größer?
Das Prinzip ist immer das Verhältnis 4/3, die tatsächliche Zunahme hängt aber ein wenig von der Originalgröße und vom Padding ab.
Da aus je 3 Bytes 4 Zeichen entstehen, ergibt sich im Idealfall eine Zunahme von etwa 33,3 %. Bleiben 1–2 Bytes übrig und es kommt ein „="-Padding hinzu, kann der Anteil bei sehr kleinen Dateien etwas höher ausfallen.
Soll ich die Data-URL oder Plain Base64 kopieren?
Für Stellen, an denen der Browser das Bild direkt darstellen soll, etwa img src in HTML oder background-image in CSS, kopieren Sie die Data-URL samt Präfix.
Wird nur der reine codierte Wert benötigt, etwa in einem API-Request-Body oder in einem separaten Speicher, verwenden Sie Plain Base64 ohne Präfix.
Die decodierte Datei lässt sich nicht als Bild öffnen. Woran liegt das?
Die häufigste Ursache: Der ursprüngliche String wurde beim Kopieren abgeschnitten oder wurde mit Leerzeichen und Zeilenumbrüchen decodiert.
Weicht der ermittelte MIME-Typ vom tatsächlichen Format ab, passt die Dateiendung nicht, und ein Bildbetrachter kann die Datei unter Umständen nicht öffnen. Prüfen Sie zuerst, ob der Originalstring vollständig ist und ob das anhand der Signatur abgeleitete Format stimmt, dann lässt sich die Ursache eingrenzen.
Was bedeutet das „=" am Ende eines Base64-Strings?
Es ist ein Padding-Zeichen (Füllzeichen). Base64 legt fest, dass die Länge der Ausgabe immer ein Vielfaches von 4 sein muss.
Lassen sich die Originaldaten nicht restlos durch 3 Bytes teilen, werden die fehlenden Stellen mit „=" aufgefüllt, damit die Länge stimmt. Es ist kein tatsächlicher Datenwert, sondern nur eine Markierung, die das Format vervollständigt.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen