Andate al contenuto
Guides8 luglio 2026· 6 min di lettura

i18n senza file di traduzione? Con i18next si può fare, già oggi

In questa pagina

« I file di traduzione sono il problema. » È un pitch popolare nel 2026: i vostri componenti sono la source of truth, quindi basta mantenere a mano JSON per ogni lingua, lasciate che il tooling generi le traduzioni e trattate i file di locale come artefatti di build. Un'intera nuova ondata di strumenti i18n è costruita su questo argomento.

La diagnosi è in parte corretta. Modificare a mano diciassette file JSON per aggiungere una frase non diverte nessuno. La parte che il pitch di solito omette: l'ecosistema i18next supporta esattamente questo workflow da anni, con semplici librerie open source, e può fare persino un passo in più, perché con la consegna via CDN nel vostro repository non c'è alcun file di traduzione, nemmeno generato. Ecco la ricetta, seguita dai compromessi onesti.

Fatti chiave
  • Chiavi in linguaggio naturale: t('Add to cart') con keySeparator: false; il testo sorgente è la chiave, una traduzione mancante mostra il testo sorgente. Nessun file inglese necessario.
  • Il rich text resta nel codice: il componente Trans serializza i figli JSX nella chiave, tag indicizzati inclusi.
  • Le nuove stringhe si traducono da sole: saveMissing le segnala; la traduzione automatica (la vostra chiave LLM o il servizio integrato) riempie tutte le lingue di destinazione; la Quality Estimation valuta ogni risultato.
  • Zero file, o file come artefatti, a scelta: la consegna CDN a runtime significa zero file di locale nel repository; l'estrazione in CI (i18next-cli) li produce come artefatti generati se preferite.
  • Ciò che « zero file » non risolve: coerenza terminologica, revisione e « chi ha approvato questo? ». I file non sono mai stati il vero problema; l'output non governato sì.

Passo 1: il codice diventa la source of truth

Due righe di configurazione trasformano i18next in un sistema a chiavi in linguaggio naturale:

i18next.init({
  keySeparator: false,
  nsSeparator: false
})

Ora il testo inglese è la chiave:

t('Add to cart')

Dietro non c'è alcuna voce en.json. Quando non esiste una traduzione, i18next ricade sulla chiave, e la chiave è il testo sorgente: l'app si renderizza correttamente dal primo secondo. Il rich text funziona allo stesso modo tramite il componente Trans, che serializza i propri figli JSX, markup incluso, nella chiave:

<Trans>Hello <strong>{{name}}</strong>, you have {{count}} unread messages.</Trans>

I traduttori vedono Hello <1>{{name}}</1>, you have {{count}} unread messages. e riordinano liberamente il markup per ogni lingua; i tag veri restano di proprietà dei vostri componenti. I suffissi di plurale e di contesto continuano a funzionare sulle chiavi naturali, perché sono decorazioni della chiave, non file separati.

Passo 2: le nuove stringhe si segnalano da sole

Questo è il pezzo che sostituisce « mantenere i file »: saveMissing. Con saveMissing: true e i18next-locize-backend, ogni stringa che la vostra app renderizza per la prima volta viene segnalata automaticamente a Locize, di solito limitato allo sviluppo così la produzione resta in sola lettura:

i18next.init({
  saveMissing: process.env.NODE_ENV === 'development'
})

Sul lato Locize, la traduzione automatica raccoglie ogni nuova stringa sorgente e riempie tutte le lingue di destinazione, sulla vostra chiave OpenAI, Gemini, Mistral o DeepL se ne portate una; un provider di IA riceve il vostro glossario e la vostra styleguide con ogni richiesta. La Quality Estimation valuta ogni risultato dell'IA da 0 a 1: le traduzioni sicure vengono salvate direttamente, quelle dubbie passano alla revisione.

Scrivete t('Your trial ends tomorrow'), ricaricate la pagina, e pochi secondi dopo la stringa esiste in ogni lingua, con punteggio. Nessuno ha aperto un file JSON.

Passo 3: consegnare senza file (o con file generati)

A runtime, lo stesso backend carica le traduzioni dal CDN di Locize. Il che significa che la versione più forte di « i file di traduzione sono artefatti di build » esiste anche qui, e di più: nel vostro repository non c'è alcun file di locale. Una correzione pubblicata nell'editor è online senza commit, senza build, senza redeploy.

Preferite una pipeline statica, o vi servono file per SSR/SSG? Prendete la via CI: i18next-cli estrae le stesse stringhe staticamente (capisce gli scope di t() e serializza i figli di Trans esattamente come react-i18next), e la GitHub Action locize/translate, gratuita, esegue estrazione, sincronizzazione, traduzione automatica e download a ogni push. I file scaricati sono artefatti generati: committateli, oppure metteteli in gitignore e scaricateli in fase di build. La vostra app non è ancora strumentata? npx i18next-cli localize la porta dalle stringhe hardcoded alla localizzazione in un solo comando, e npx i18next-cli localize --print-agent-prompt stampa lo stesso flusso come runbook per il vostro agente di coding IA.

I compromessi onesti

Le chiavi in linguaggio naturale sono uno scambio, non un upgrade gratuito, e vale la pena sapere cosa si paga. (Per il quadro decisionale completo sulle strategie di chiavi, incluso quando il content-as-key è la scelta giusta e quando no, vedete la nostra guida alla nomenclatura delle chiavi i18n.)

  • Modificare il testo ri-genera la chiave. Cambiate « Add to cart » in « Add to basket » ed è una nuova chiave: ritradotta, mentre la vecchia viene rimossa alla sincronizzazione successiva. La translation memory ammortizza il costo, le traduzioni già revisionate tornano come corrispondenze ad alto punteggio, ma per i testi che ruotano ogni settimana le chiavi stabili con defaultValue restano lo strumento migliore. i18next permette di mescolare i due stili nello stesso progetto; molti team usano chiavi naturali per i testi UI stabili e chiavi stabili per il copy marketing.
  • Un testo lungo fa una chiave lunga. Tre paragrafi di note legali come chiave sono sgradevoli in qualunque strumento che mostri le chiavi. Date a quelle stringhe una chiave stabile e un defaultValue.
  • L'ambiguità richiede contesto. L'inglese « Open », verbo o aggettivo, può richiedere due traduzioni diverse. La funzionalità di contesto di i18next (t('Open', { context: 'button' })) copre il caso, ma l'ambiguità bisogna accorgersene; un workflow centrato sui file non vi protegge di più.

Ciò che « zero file » non risolve

Eliminare la manutenzione dei file elimina una seccatura. Non elimina i problemi davvero difficili della localizzazione, ed è qui che il pitch « il tuo codice è la source of truth » finisce in silenzio: la terminologia che non deve derivare, il registro che non deve capovolgersi a metà app, le stringhe legali che richiedono occhi umani, e la domanda « chi ha approvato questa traduzione? », a cui una pipeline di output bot non revisionato risponde con un hash di commit. Abbiamo documentato cosa si rompe davvero nelle pipeline solo-IA, e nessuna delle modalità di guasto riguarda i formati di file.

Questa è la vera differenza tra i workflow, con o senza file: se l'output tradotto atterra in uno strato governato, con coerenza imposta dal glossario, punteggi di qualità, revisione umana selettiva e cronologia di audit, oppure direttamente in produzione. Input senza chiavi più output non governato è solo deriva più veloce.

Provate l'intero loop in un pomeriggio

Configurate le chiavi in linguaggio naturale e saveMissing in un branch, create un progetto Locize gratuito, attivate la traduzione automatica e guardate le nuove stringhe comparire tradotte e valutate mentre navigate la vostra app. Se gestite già una pipeline IA in CI e vi chiedete in che stato siano i vostri file di locale, il check di salute i18n gratuito gira interamente nel browser e mostra chiavi mancanti, duplicati e incongruenze di interpolazione prima di cambiare qualsiasi cosa.

I file di traduzione non sono mai stati il punto. Le traduzioni affidabili in produzione sì, che i file esistano o no.

Domande frequenti

i18next può funzionare senza chiavi di traduzione?

Sì. Con keySeparator: false e nsSeparator: false il testo inglese diventa esso stesso la chiave: t("Add to cart") non richiede alcuna voce in en.json, perché una traduzione mancante ricade sulla chiave, che è il testo sorgente. Per il rich text, il componente Trans serializza i propri figli JSX (con tag indicizzati come <0>) nella chiave, quindi il markup resta nel codice.

Come vengono tradotte le nuove stringhe se nessuno mantiene i file?

Tramite saveMissing. Con saveMissing attivo, i18next segnala a Locize ogni stringa renderizzata per la prima volta; la traduzione automatica (la vostra chiave OpenAI, Gemini, Mistral o DeepL, oppure il servizio integrato) riempie tutte le lingue di destinazione e la Quality Estimation assegna un punteggio a ogni risultato. Preferite una pipeline alla segnalazione a runtime? i18next-cli estrae le stesse stringhe staticamente in CI.

Cosa succede quando modifico il testo sorgente?

La stringa modificata è una nuova chiave: viene ritradotta, e la vecchia chiave viene rimossa alla sincronizzazione successiva. La translation memory ammortizza il costo: le traduzioni già revisionate di stringhe simili tornano come corrispondenze ad alto punteggio invece di essere ritradotte da zero. Per i testi che cambiano di continuo, le chiavi stabili restano lo strumento migliore, e i18next permette di mescolare i due stili nello stesso progetto.

Servono comunque file di traduzione per SSR o SSG?

Solo come snapshot opzionali in fase di build. Lato client, i18next-locize-backend carica le traduzioni direttamente dal CDN, quindi il repository non contiene alcun file di locale. Per il rendering lato server o le build statiche, scaricate uno snapshot in CI (locize-cli download o la GitHub Action locize/translate) e trattatelo come un artefatto generato, che nessuno modifica a mano.

Stanchi di gestire le traduzioni a mano?

Locize è il backend di gestione delle traduzioni creato dal team di i18next: distribuzione via CDN, traduzione con AI, editing in-context, senza nuovi deploy.

Iniziate la prova gratuita di 14 giorni

Articoli correlati