Scegli lingua

Convertitore da Base64 a file

Incolla una stringa Base64 e scaricala come file. Riconosce il prefisso Data URI, imposta nome ed estensione e rileva il tipo MIME del contenuto.

Mehmet Demiray Pubblicato Aggiornato
Condividi
Nome per il file scaricato; l’estensione viene aggiunta in base al tipo rilevato

A cosa serve la conversione da Base64 a file

Il Base64 è un sistema di codifica che rappresenta dati binari usando soltanto 64 caratteri di testo stampabili. Viene usato ovunque sia necessario trasportare un file dentro un contesto pensato per il testo: e-mail, documenti JSON, fogli di stile, risposte di API o token. Il problema arriva quando ricevi una di queste stringhe e ti serve di nuovo il file originale, che sia un'immagine, un PDF o un archivio.

Questo strumento fa esattamente il percorso inverso della codifica. Tu incolli la stringa, lui ricostruisce i byte originali e te li restituisce come file pronto da scaricare. Non devi aprire un editor, scrivere codice o installare librerie.

È utile per chi lavora con il debug di API, per chi estrae allegati incorporati in un payload e per chi deve verificare il contenuto reale di un Data URI. Se invece parti da un file e vuoi ottenere la stringa, il percorso opposto è gestito da File a Base64.

Come usare lo strumento passo dopo passo

L'uso è lineare e richiede pochi secondi. Segui questi passaggi:

  1. Incolla la stringa Base64 nel campo di testo. Puoi inserire sia il valore puro sia un Data URI completo come data:image/png;base64,iVBORw0KGgo.
  2. Controlla il tipo rilevato. Se la stringa contiene un prefisso Data URI, lo strumento legge il tipo MIME e propone l'estensione corretta.
  3. Imposta il nome del file se vuoi un'etichetta personalizzata, altrimenti viene usato un nome predefinito.
  4. Scarica il risultato con il pulsante dedicato.

Quando manca il prefisso Data URI, il rilevamento avviene leggendo i primi byte decodificati, la cosiddetta firma del file. Una stringa che inizia con JVBERi0 indica un PDF, mentre iVBORw0KGgo indica un PNG.

Tutta la decodifica avviene nel tuo browser. La stringa che incolli non viene inviata a un server, quindi puoi trattare anche contenuti riservati con tranquillità. Per controllare in anticipo a quale formato corrisponde un tipo, è comodo verificare il tipo MIME.

Data URI, prefissi e tipo MIME

Un Data URI incorpora un file intero dentro una singola stringa. La sua struttura segue uno schema preciso:

data:[<tipo-mime>][;base64],<dati>

La parte iniziale dichiara il tipo del contenuto, ad esempio image/png, application/pdf o text/plain. Il segmento ;base64 segnala che i dati che seguono sono codificati, e tutto ciò che viene dopo la virgola è la stringa vera e propria.

Quando lo strumento riceve un Data URI, estrae il tipo MIME e lo usa per due cose: assegnare l'estensione giusta al file scaricato e impostare l'attributo corretto al momento del salvataggio. Questo evita che un'immagine venga salvata come file generico privo di estensione.

Se la stringa è priva di prefisso, il rilevamento si basa sulla firma binaria iniziale. Ecco alcune corrispondenze frequenti:

Inizio Base64 Tipo Estensione
iVBORw0KGgo PNG .png
/9j/ JPEG .jpg
JVBERi0 PDF .pdf
UEsDB ZIP .zip

In caso di dubbio puoi sempre confrontare il valore con Controllo Tipo MIME.

Come funziona la decodifica Base64

La codifica Base64 raggruppa i dati binari in blocchi da 3 byte, cioè 24 bit, e li riscrive come 4 caratteri da 6 bit ciascuno. Questo è il motivo per cui una stringa Base64 è sempre circa un terzo più lunga del file originale: aggiunge spazio di testo in cambio della compatibilità.

La decodifica inverte il procedimento. Ogni quattro caratteri vengono riconvertiti nei tre byte di partenza, ricostruendo i dati originali bit per bit. Il segno = finale è un riempimento che indica quanti byte mancavano per completare l'ultimo blocco.

La relazione tra dimensione codificata e dimensione del file segue una formula semplice:

Lbase64=4n3L_{base64} = 4 \cdot \left\lceil \frac{n}{3} \right\rceil

dove n è il numero di byte del file originale. Per stimare il file di partenza da una stringa già codificata puoi usare la relazione inversa, che restituisce circa il 75% della lunghezza della stringa. Per ottenere la versione testuale di un contenuto puoi affidarti a Decodifica Base64.

Errori comuni e come evitarli

La maggior parte dei problemi nasce da stringhe incomplete o sporche. Tenere a mente alcuni punti riduce quasi del tutto gli errori:

  • Caratteri di troppo: spazi, interruzioni di riga o virgolette copiate per sbaglio possono invalidare la decodifica. Pulisci la stringa prima di incollarla.
  • Riempimento mancante: una stringa Base64 valida ha una lunghezza multipla di 4. Se i caratteri = finali sono stati tagliati, la decodifica può fallire.
  • Variante URL-safe: alcune stringhe usano - e _ al posto di + e /. Sono valide ma seguono lo standard Base64URL, comune nei token JWT.
  • Prefisso parziale: copiare data:image/png;base64, senza i dati che seguono produce un file vuoto.

Se il file scaricato non si apre, il primo controllo è l'estensione: un PDF salvato come .txt non verrà riconosciuto dal sistema. In secondo luogo verifica che la stringa sia stata copiata per intero, perché un troncamento anche di pochi caratteri rovina l'ultimo blocco. Per fare il percorso opposto e generare una stringa pulita da un file parti da File in Base64.

Le più frequenti.

Posso incollare un Data URI completo?

Sì. Puoi inserire sia la stringa Base64 pura sia un Data URI completo come data:application/pdf;base64,JVBERi0xLjc. Quando è presente il prefisso, lo strumento legge il tipo MIME e assegna automaticamente l'estensione corretta al file scaricato. Se il prefisso manca, il tipo viene dedotto dalla firma binaria iniziale.

I dati che incollo vengono caricati su un server?

No. L'intera decodifica avviene direttamente nel tuo browser. La stringa non lascia il dispositivo e non viene trasmessa a nessun server esterno, quindi puoi trattare anche contenuti riservati senza preoccupazioni sulla privacy.

Come faccio a sapere che tipo di file otterrò?

Se la stringa contiene un prefisso Data URI, il tipo è dichiarato esplicitamente e viene mostrato prima del download. In assenza di prefisso, lo strumento esamina i primi byte decodificati, la firma del file, e riconosce i formati più comuni come PNG, JPEG, PDF e ZIP. Per un controllo aggiuntivo puoi usare Controllo Tipo MIME.

Perché la decodifica fallisce o produce un file danneggiato?

Le cause più frequenti sono una stringa troncata, la presenza di spazi o interruzioni di riga, oppure il riempimento = mancante. Una stringa valida ha una lunghezza multipla di 4. Pulisci il testo da caratteri estranei e assicurati di averlo copiato per intero, dal primo all'ultimo carattere.

Lo strumento gestisce la variante Base64URL?

La variante URL-safe sostituisce i caratteri + e / con - e _ ed è tipica dei token JWT e dei parametri negli indirizzi web. È una codifica valida e supportata. Se incolli una stringa di questo tipo, viene decodificata correttamente come quella standard.

Posso fare il percorso inverso, da file a Base64?

Sì, ma con uno strumento dedicato. Per trasformare un file in una stringa Base64 usa File a Base64. Se invece ti serve solo decodificare testo verso la sua forma leggibile, lo strumento adatto è Decodifica Base64.