Koder Plików Base64

Czym Jest Kodowanie Plików Base64?

Kodowanie plików Base64 konwertuje pliki binarne — PDF, ZIP, obrazy, pliki wykonywalne, czcionki, audio — na zwykły tekst ASCII przy użyciu alfabetu zdefiniowanego w RFC 4648. Każde trzy bajty danych binarnych wejścia stają się czterema znakami Base64, tworząc reprezentację tekstową, która może być przesyłana przez kanały przeznaczone wyłącznie dla tekstu: ładunki API JSON, dokumenty XML, treść poczty elektronicznej, atrybuty HTML i zmienne środowiskowe.

W przeciwieństwie do kodowania tekstu do Base64 (które działa na ciągach), kodowanie pliku do Base64 odczytuje surowy strumień bajtów dowolnego pliku niezależnie od jego formatu. Nagłówki binarne PDF, skompresowane bloki ZIP i dane pikseli PNG są traktowane identycznie: jako sekwencja oktetów do ponownego kodowania. Wynik jest zawsze prawidłowym ASCII, bezpiecznym do osadzenia wszędzie tam, gdzie akceptowane są znaki drukowalne.

Kompromisem jest rozmiar: wyjście Base64 jest około 33% większe niż oryginalne dane binarne. W przypadku pliku PDF o rozmiarze 1 MB oznacza to około 1,33 MB tekstu Base64. Ten narzut jest nieodłączny od kodowania i żadna implementacja nie może go uniknąć. Mimo to kodowanie plików Base64 pozostaje standardową metodą osadzania danych binarnych w formatach tylko tekstowych, określoną w MIME (RFC 2045), URI danych (RFC 2397) i JSON Web Tokens (RFC 7519).

Dlaczego Używać tego Kodera Plików Base64?

To narzędzie koduje pliki do Base64 bezpośrednio w twojej przeglądarce za pomocą interfejsu API FileReader. Żaden plik nie jest przesyłany na serwer — cała konwersja odbywa się po stronie klienta w JavaScript.

Przypadki Użycia Kodowania Plików Base64

Narzut Rozmiaru Pliku Base64

Kodowanie Base64 zwiększa rozmiar danych dokładnie o jedną trzecią. Każde 3 bajty wejścia tworzą 4 znaki wyjścia (każdy reprezentujący 6 bitów). Znaki dopełnienia (=) są dodawane, gdy długość wejścia nie jest wielokrotnością 3. Poniższa tabela pokazuje relację między rozmiarem oryginalnego pliku a rozmiarem zakodowanego wyjścia.

Odnośnik do URI Danych i Typu MIME

URI danych osadza zawartość pliku bezpośrednio w HTML, CSS lub JavaScript przy użyciu formatu data:[typ MIME];base64,[zakodowane dane]. Typ MIME mówi przeglądarce, jak interpretować zdekodowane bajty. Poniżej znajdują się wspólne rozszerzenia plików, ich typy MIME i odpowiadający im prefiks URI danych.

Przykłady Kodu

Te wykonalne przykłady pokazują, jak czytać plik binarny i kodować go do Base64 w JavaScript, Python, Node.js, bash i Go. Każdy fragment tworzy standardowy Base64 (RFC 4648 Sekcja 4) z dopełnieniem.

// Read a file from an <input> element and encode to Base64
const input = document.querySelector('input[type="file"]')
input.addEventListener('change', (e) => {
  const file = e.target.files[0]
  const reader = new FileReader()
  reader.onload = () => {
    const base64 = reader.result.split(',')[1]
    console.log(base64) // → "JVBERi0xLjQK..." (raw Base64, no data URI prefix)
  }
  reader.readAsDataURL(file)
})

// Convert a Blob to Base64 with async/await
async function blobToBase64(blob) {
  const buffer = await blob.arrayBuffer()
  const bytes = new Uint8Array(buffer)
  let binary = ''
  bytes.forEach(b => binary += String.fromCharCode(b))
  return btoa(binary) // → standard Base64 string
}

import base64
from pathlib import Path

# Encode a file to Base64
file_bytes = Path('document.pdf').read_bytes()
encoded = base64.b64encode(file_bytes).decode('ascii')
print(encoded[:40])  # → "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PA..."

# Write encoded output to a text file
Path('document.b64.txt').write_text(encoded)

# Build a data URI from a file
mime_type = 'application/pdf'
data_uri = f'data:{mime_type};base64,{encoded}'
print(data_uri[:60])  # → "data:application/pdf;base64,JVBERi0xLj..."

import { readFileSync, writeFileSync } from 'fs'

// Encode a file to Base64
const buffer = readFileSync('archive.zip')
const base64 = buffer.toString('base64')
console.log(base64.length) // → 1398104 (for a ~1 MB file)

// Save Base64 output to a file
writeFileSync('archive.b64.txt', base64)

// Build a data URI
const mime = 'application/zip'
const dataUri = `data:${mime};base64,${base64}`

# Encode a file to Base64 (macOS / Linux)
base64 < document.pdf > document.b64.txt

# Encode with no line wrapping (GNU coreutils)
base64 -w 0 < document.pdf > document.b64.txt

# Encode and copy to clipboard (macOS)
base64 < image.png | pbcopy

# Encode with OpenSSL (available everywhere)
openssl base64 -in archive.zip -out archive.b64.txt

# Pipe directly into curl for API upload
base64 -w 0 < photo.jpg | curl -X POST -d @- https://api.example.com/upload

package main

import (
	"encoding/base64"
	"fmt"
	"os"
)

func main() {
	data, err := os.ReadFile("document.pdf")
	if err != nil {
		panic(err)
	}
	encoded := base64.StdEncoding.EncodeToString(data)
	fmt.Println(len(encoded)) // → 1398104 (for a ~1 MB file)

	// Write to file
	os.WriteFile("document.b64.txt", []byte(encoded), 0644)
}

Często Zadawane Pytania