Декодер Base64: декодировать Base64 в текст онлайн

Как декодировать Base64

1. Вставьте Base64 в поле Ввод · Base64. Переносы строк, пробелы, кавычки вокруг и префикс data:...;base64, можно не убирать: декодер удалит их сам.
2. Декодированный текст появится в поле Результат · текст. Строка статуса сообщает Корректный Base64, вариант (Standard или Base64URL), число декодированных байтов, а в поле Похоже на показывает тип содержимого.
3. Если текст искажён, смените Кодировку или выберите Автоопределение.
4. Если внутри JSON, Форматировать JSON расставит отступы для удобного чтения.
5. Нажмите Скопировать результат или Скачать, чтобы сохранить декодированные байты файлом. Расширение зависит от определённого типа, так что JSON сохраняется как decoded.json, а PNG как decoded.png.

Поменять местами отправляет декодированный текст обратно во ввод и переключает на кодирование. Так легко убедиться, что строка проходит туда и обратно без потерь.

Что принимает декодер

Base64 редко приходит чистым. Он бывает разбит по 76 символов из письма, взят в кавычки из JSON-файла, percent-кодирован из URL или лишён дополнения в токене. Декодер принимает всё это без каких-либо настроек:

К такой упаковке декодер снисходителен, а ко всему остальному строг. Символ вне алфавита его останавливает, ошибка называет символ и его позицию, и дальше декодер ничего не угадывает. Некоторые библиотеки поступают иначе: молча пропускают плохие символы и отдают испорченный результат (см. раздел с кодом ниже).

Для URL-safe токенов отдельно есть декодер Base64URL, который объясняет алфавит, а различия разобраны в статье Base64 и Base64URL.

Если в Base64 закодирован файл

Base64 переносит любые байты, и во многих строках Base64 лежат картинки или документы. Инструмент сверяет первые байты декодированных данных с известными сигнатурами файлов (magic numbers) и показывает итог в поле Похоже на: PNG, JPEG, PDF, ZIP, gzip, JSON, XML и многое другое. Для двоичных форматов он показывает печатный предпросмотр, сообщает, что данные двоичные, и даёт ссылку на нужный инструмент, например Base64 в картинку или Base64 в PDF. Скачать в любом случае сохраняет исходные байты.

Начало строки Base64 часто выдаёт формат ещё до декодирования:

Больше сигнатур собрано в статье о частых префиксах Base64. Для файла неизвестного типа есть Base64 в файл: он определит формат и покажет предпросмотр.

Кодировки: как починить кракозябры

Base64 хранит байты и ничего не говорит о том, какая кодировка превратила символы в эти байты. Декодер предполагает UTF-8, и для большинства современных данных это верно. Когда нет, симптомы узнаваемы:

• Символы � и пометка «Часть байтов не читается как UTF-8». Текст пришёл в устаревшей кодировке. Y2Fm6Q== читается как caf� в UTF-8 и как café в ISO-8859-1 или Windows-1252. Русскому тексту вроде z/Do4uXy нужна Windows-1251, чтобы показать Привет.
• Точка или пропуск после каждой буквы. Это UTF-16, где за ASCII-буквами идёт нулевой байт. SABlAGwAbABvAA==, например, даёт Hello в UTF-16LE (Base64 в UTF-16).
• é, ü или ’ в результате. Декодирование правильное: текст был закодирован дважды ещё до превращения в Base64 (байты UTF-8 прочитали как Latin-1 и снова сохранили в UTF-8). Y2Fmw4PCqQ== декодируется ровно в café. Исправлять нужно в источнике.

Автоопределение проверяет наличие метки порядка байтов, затем корректность UTF-8, затем шаблон нулевых байтов UTF-16. Однобайтовые кодовые страницы вроде Windows-1251 и KOI8-R для любого детектора выглядят одинаково, поэтому, если вы знаете источник, выбирайте их вручную.

Сообщения об ошибках и что они значат

Каждый случай подробнее разобран в руководстве по ошибкам Base64. Найти, в каком именно символе или в дополнении ошибка, поможет валидатор Base64.

Декодирование Base64 в JavaScript, Python и командной строке

atob() возвращает «двоичную строку» по символу на байт, поэтому для текста в UTF-8 нужен ещё шаг с TextDecoder. atob принимает строки без дополнения, но выбрасывает InvalidCharacterError на URL-safe - и _.

const s = "R3LDvMOfZSDwn5GL";
new TextDecoder().decode(Uint8Array.from(atob(s), c => c.charCodeAt(0)));
// "Grüße 👋"

// Node.js accepts both alphabets
Buffer.from(s, "base64").toString("utf8");          // "Grüße 👋"
Buffer.from("8J-Riw", "base64url").toString("utf8"); // "👋"

Python выбрасывает binascii.Error: Incorrect padding на входе без дополнения, так что допишите его сами:

import base64

s = "SGVsbG8"
base64.b64decode(s + "=" * (-len(s) % 4)).decode("utf-8")
# 'Hello'
base64.b64decode("SGVs*bG8=", validate=True)
# binascii.Error: Only base64 data is allowed

Без validate=True Python молча отбрасывает * и возвращает b'Hello'. Buffer.from в Node ведёт себя так же, так что повреждённая строка может декодироваться без всякой ошибки.

В командной строке:

printf '%s' 'R3LDvMOfZSDwn5GL' | base64 -d
base64 -d message.b64 > message.bin

Первая строка выводит Grüße 👋. В старых версиях macOS флаг пишется как -D. Подробнее по языкам: JavaScript, Node.js, Python, PHP.

Вопросы и ответы