Perché il mio QR code mostra caratteri strani? (UTF-8 spiegato)

I caratteri strani nel risultato di un QR — Café invece di Café, Müller invece di Müller, quadratini o punti interrogativi al posto del cirillico — si riducono quasi sempre a una cosa: una discrepanza di codifica dei caratteri. Il codice è stato creato con la codifica del testo sbagliata, quindi il telefono decodifica male le lettere accentate o non latine. La soluzione è generarlo in UTF-8 fin dall'inizio.

Che aspetto ha il pasticcio

I sintomi si riconoscono una volta visti:

• Caratteri «Ã» in più: Café diventa Café, Müller diventa Müller, Señor diventa Señor.
• Quadratini o punti interrogativi: мой o 北京 escono come ���, □□□ o ???.
• Emoji mancante: un'emoji sparisce o diventa un quadratino.

Il testo ASCII semplice — a–z, 0–9, punteggiatura di base — non è mai toccato. Il problema riguarda solo le lettere accentate (é, ü, ñ, ç, å), le scritture non latine (cirillico, greco, arabo, cinese) e le emoji.

La vera causa: come un QR code memorizza il testo

Un QR code non memorizza lettere; memorizza byte. Per trasformare la parola «Café» in byte, il generatore deve scegliere una codifica dei caratteri: una tabella che mappa le lettere su numeri. Lo standard moderno è UTF-8, ed è ciò che le fotocamere dei telefoni si aspettano.

I guai iniziano quando un generatore usa invece una vecchia codifica a un byte — ISO-8859-1 (Latin-1) o Windows-1252 — o produce UTF-8 senza segnalarlo. UTF-8 scrive «é» con due byte; Latin-1 con uno. Quando i byte scritti con una codifica vengono riletti con un'altra, il telefono ricostruisce il carattere sbagliato e ottieni Café. Sembra un bug del telefono, ma la discrepanza è stata inserita nel codice al momento della generazione.

Dove colpisce di più

Ovunque un QR code porti testo direttamente, non solo un link:

• Codici WiFi con nome rete o password accentati — il telefono prova a unirsi a «Café-Guest» e fallisce, o mostra il nome sbagliato.
• Codici contatto vCard il cui nome ha un accento — José, Müller o qualsiasi nome cirillico si salva male.
• Codici testo e nota in qualsiasi lingua diversa dall'inglese.
• URL con caratteri non ASCII non codificati in percentuale.

Come risolverlo

Usa un generatore che codifica in UTF-8. Questa sola scelta risolve ogni caso qui sopra. I nostri strumenti gratuiti lo fanno di proposito: la libreria di base usa Latin-1 per impostazione predefinita, quindi la impostiamo su UTF-8 proprio per questo:

• Il generatore di QR code WiFi gestisce correttamente i nomi rete accentati e non latini.
• Il generatore di QR code vCard conserva José, Müller e i nomi cirillici.

Se generi codici nel tuo software, forza la modalità byte UTF-8. Per la massima compatibilità con i lettori vecchi, alcuni codici aggiungono un marcatore ECI che dichiara il set di caratteri allo scanner — il supporto è disomogeneo, quindi la via affidabile è codificare in UTF-8 e provare su un telefono vero.

Controlla prima di stampare

La prova più sicura è scansionare il tuo codice e leggere cosa dice. Caricalo nel verificatore di scansione QR gratuito: decodifica l'immagine e mostra il testo esatto contenuto nel codice, così vedi «Café» o «Café» prima che arrivi a un cliente. Se lì è strano, rigeneralo in UTF-8 — un codice stampato non si corregge dopo.

Domande frequenti

Perché il mio QR code WiFi mostra male il nome della rete?

Il nome della rete o la password contiene un carattere accentato o non latino, e il codice è stato creato in Latin-1 invece che in UTF-8. Ricrealo con un generatore UTF-8 e il nome arriva corretto.

Perché il mio QR di contatto scrive male il mio nome?

Stessa causa: una vCard con nome accentato o cirillico codificata nel set di caratteri sbagliato. Un generatore di vCard UTF-8 lo risolve.

Il QR code registra la lingua o il set di caratteri?

Non per impostazione predefinita. In modalità byte un QR memorizza byte grezzi senza set di caratteri associato, e i lettori presumono UTF-8. Un codice può includere un marcatore ECI per dichiarare esplicitamente il set di caratteri, ma non tutti i lettori lo rispettano — ecco perché codificare in UTF-8 e provare è la combinazione sicura.

Posso correggere un QR code già stampato?

No. I byte sono fissi nel motivo stampato, quindi un codice WiFi o vCard con caratteri strani va rigenerato in UTF-8 e ristampato. Un codice di reindirizzamento dinamico è diverso — puoi cambiarne la destinazione — ma qui il pasticcio vive nei dati incorporati, non in un link.

Le emoji funzionano nei QR code?

Sì, purché il codice sia UTF-8 — le emoji sono caratteri UTF-8 multibyte. Un generatore Latin-1 non può rappresentarle affatto. Le emoji rendono anche il codice più denso, quindi tieni corto il resto del contenuto.

Crea un codice che azzecca i caratteri al primo colpo — prova i generatori WiFi e vCard gratuiti, oppure crea un codice dinamico con logo e statistiche.