Dekodowanie Base64

Powiązane Rekomendacje

Czym jest dekodowanie Base64?

Przypadki użycia

• Dekodowanie pól Base64 zwracanych przez API w celu sprawdzenia oryginalnej treści
• Przywracanie danych zakodowanych w Base64 z logów
• Odzyskiwanie wartości Base64 z plików konfiguracyjnych
• Analiza błędów dekodowania Base64, takich jak brak paddingu lub nieprawidłowe znaki
• Dekodowanie segmentów header i payload JWT w celu sprawdzenia informacji o użytkowniku
• Dekodowanie poświadczeń HTTP Basic Authentication w celu odczytu nazwy użytkownika i hasła
• Przywracanie obrazów lub danych zasobów z Data URI Scheme

Jak Używać

1. Wklej ciąg Base64, który chcesz zdekodować
2. Wybierz zestaw znaków (UTF-8/ASCII/ISO-8859-1)
3. Narzędzie automatycznie zdekoduje Base64 i pokaże wynik
4. Skopiuj wynik do dalszego debugowania lub dokumentacji

Funkcje

• Konwersja w czasie rzeczywistym: po wpisaniu danych następuje automatyczne dekodowanie z opóźnieniem 300 ms, bez ręcznego uruchamiania
• Obsługa wielu zestawów znaków: UTF-8, ASCII i ISO-8859-1 dla języka polskiego, angielskiego i scenariuszy wielojęzycznych
• Zgodność z URL-safe Base64: automatycznie obsługuje zamianę `-` i `_` oraz formaty bez paddingu
• Wykrywanie nieprawidłowych znaków: przy błędzie dekodowania wskazuje miejsce problemu w ciągu
• Kopiowanie i pobieranie jednym kliknięciem: wynik można skopiować do schowka lub pobrać jako plik `.txt`
• Automatyczna obsługa paddingu: znaki `=` są automatycznie uzupełniane lub usuwane
• Obsługa wariantu MIME: rozpoznaje i przetwarza Base64 MIME z podziałem wierszy co 76 znaków

Przykłady kodu

// Standard Base64 decode (plain English / Latin-1)
function b64Decode(str) {
  try {
    return atob(str);
  } catch (e) {
    return 'Decode failed: ' + e.message;
  }
}

console.log(b64Decode('SGVsbG8gV29ybGQ=')); // "Hello World"

// UTF-8 decode (recommended)
function b64DecodeUtf8(str) {
  const binary = atob(str);
  const bytes = new Uint8Array(binary.length);
  for (let i = 0; i < binary.length; i++) {
    bytes[i] = binary.charCodeAt(i);
  }
  return new TextDecoder('utf-8').decode(bytes);
}

console.log(b64DecodeUtf8('5LiW55WM')); // UTF-8 text

import base64

# Standard decode
encoded = 'SGVsbG8g5LiW55WM'
decoded = base64.b64decode(encoded).decode('utf-8')
print(decoded)

# URL-Safe decode
url_encoded = 'SGVsbG8g5LiW55WM'
decoded = base64.urlsafe_b64decode(url_encoded + '=' * (4 - len(url_encoded) % 4))
print(decoded.decode('utf-8'))

# MIME decode (after removing line breaks)
mime_encoded = 'SGVs\nbG8g\nV29y\nbGQ='
decoded = base64.b64decode(mime_encoded.replace('\n', '')).decode('utf-8')
print(decoded)

# Ignore invalid characters automatically
import re
cleaned = re.sub(r'[^A-Za-z0-9+/=]', '', encoded)
decoded = base64.b64decode(cleaned).decode('utf-8')
print(decoded)

import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class Base64DecodeExample {
    public static void main(String[] args) {
        String encoded = "SGVsbG8g5LiW55WM";

        // Standard decode
        byte[] decoded = Base64.getDecoder().decode(encoded);
        System.out.println(new String(decoded, StandardCharsets.UTF_8));

        // URL-Safe decode
        byte[] urlDecoded = Base64.getUrlDecoder().decode(encoded);
        System.out.println(new String(urlDecoded, StandardCharsets.UTF_8));

        // MIME decode (handles line breaks automatically)
        String mime = "SGVs\nbG8g\nV29y\nbGQ=";
        byte[] mimeDecoded = Base64.getMimeDecoder().decode(mime);
        System.out.println(new String(mimeDecoded, StandardCharsets.UTF_8));

        // Error handling
        try {
            Base64.getDecoder().decode("invalid@base64");
        } catch (IllegalArgumentException e) {
            System.err.println("Decode failed: " + e.getMessage());
        }
    }
}

Często Zadawane Pytania

Słownik

Base64

Metoda kodowania binarnego do tekstu oparta na 64 drukowalnych znakach ASCII, zdefiniowana w RFC 4648. Każde 3 bajty są zamieniane na 4 znaki, więc rozmiar rośnie o około 33%.

atob()

Natywna funkcja przeglądarki do dekodowania Base64 (ASCII to Binary). Obsługuje tylko Latin-1, więc dla UTF-8 wymaga użycia TextDecoder.

Padding

Na końcu Base64 dodawane są znaki `=`, aby długość była wielokrotnością 4. Podczas dekodowania padding jest zwykle obsługiwany automatycznie. Wariant URL-safe często go pomija.

URL-Safe Base64

Wariant bezpieczny dla URL, zdefiniowany w RFC 4648 §5, używający `-` i `_` zamiast `+` i `/`. Często stosowany w JWT i OAuth PKCE.

MIME Base64

Wariant Base64 zgodny z RFC 2045, który wstawia znak CRLF co 76 znaków. Jest używany głównie do przesyłania załączników e-mail.

UTF-8

Kodowanie Unicode o zmiennej długości. Aby poprawnie przywrócić znaki wielobajtowe, podczas dekodowania Base64 należy wybrać UTF-8.

InvalidCharacterError

Błąd zgłaszany przez `atob()`, gdy w danych wejściowych pojawią się znaki nienależące do Base64, takie jak spacje, nowe linie czy inne nieprawidłowe symbole.

Latin-1 (ISO-8859-1)

Jednobajtowy zestaw znaków dla języków Europy Zachodniej. `atob` i `btoa` w przeglądarce obsługują tylko ten zestaw i nie przetwarzają bezpośrednio UTF-8.

Porównanie 3 wariantów Base64

Przed dekodowaniem rozpoznaj wariant Base64 na wejściu i wybierz właściwy tryb, aby uniknąć błędów lub uszkodzonego wyniku.

5 typowych błędów podczas dekodowania Base64

Gdy pojawi się błąd dekodowania, skorzystaj z poniższej tabeli, aby szybko ustalić przyczynę.

Authoritative References

• IETFRFC 4648 - Kodowania danych Base16, Base32 i Base64
• IETFRFC 2045 - MIME Part One: Format of Internet Message Bodies
• IETFRFC 7519 - JSON Web Token (JWT)
• MDNMDN - Window atob()
• MDNMDN - Window btoa()
• MDNMDN - TextDecoder
• WikipediaWikipedia - Base64