---
name: translation-key-drift-guard
description: À utiliser sur tout site dont les clés de traduction sont le texte source anglais, où modifier un titre fait silencieusement revenir toutes les autres langues à l'anglais.
---

# Garde-fou contre la dérive des clés de traduction

Utiliser les chaînes anglaises comme clés de traduction est pratique jusqu'au jour où quelqu'un modifie l'anglais. La clé ne correspond plus, chaque locale retombe sur la clé, et la page s'affiche en anglais sans erreur, sans avertissement et sans test en échec. La régression reste invisible jusqu'à ce qu'un locuteur natif la remarque.

## Ce qu’il vous faut d’abord

- L'arborescence source contenant les appels de traduction
- Les fichiers de locale

## Méthode

1. Extrayez chaque littéral passé à la fonction de traduction dans les templates et le code applicatif, en gérant les deux styles de guillemets.
2. Comparez cet ensemble aux clés présentes dans chaque fichier de locale. Tout ce qui figure dans le source mais manque dans une locale est une chaîne qui s'affichera silencieusement en anglais.
3. Vérifiez la parité des placeholders dans les deux sens : une clé contenant un placeholder nommé dont la traduction l'a perdu produit une phrase cassée à l'exécution, pas une erreur.
4. Signalez comme orphelines les clés présentes dans une locale mais absentes du source — élaguables sans risque, et signe qu'une chaîne anglaise a été modifiée.
5. Branchez la vérification dans le processus de release pour qu'elle sorte avec un code non nul. Une vérification que personne ne lance n'est pas une vérification.
6. Prouvez qu'elle échoue : supprimez une clé, confirmez que l'exécution casse, puis restaurez. Une assertion qu'on n'a jamais vue échouer n'inspire pas confiance.

## Ce que ça produit

Un rapport par locale des clés manquantes, des placeholders discordants et des orphelines, avec un code de sortie non nul capable de bloquer un déploiement.

## Là où ça dérape

- Construire la vérification sans jamais confirmer qu'elle échoue sur une régression réelle
- Ignorer la parité des placeholders, qui casse les phrases au lieu de simplement les remettre en anglais
- Traiter les clés orphelines comme du bruit alors qu'elles témoignent le plus souvent d'un texte anglais modifié sans mise à jour des locales

---

Extrait de la bibliothèque de compétences QuQi - https://www.quqi.io/fr/skills/translation-key-drift-guard