Turborepo, Nx et Bazel : en quoi la mise en cache des builds dans les monorepos diffère réellement en 2026

Chaque outil de build pour monorepo vend le même argument : hacher les entrées d'une tâche, ignorer la tâche si ce hash a déjà été construit, et partager le cache au sein de l'équipe afin que personne ne reconstruise ce qu'un collègue a déjà construit dix minutes plus tôt. Turborepo, Nx et Bazel font tous les trois cela. La thèse de cet article est que cet argument ne représente que les 20 pour cent faciles du problème — les véritables différences entre ces outils apparaissent dans la justesse du cache, l'exécution distante, et ce qui se passe lorsqu'un dépôt dépasse quelques centaines de paquets, et ces différences devraient guider le choix bien plus que les tableaux comparatifs marketing.
Turborepo : adoption rapide, garanties plus limitées
L'attrait de Turborepo est qu'il s'intègre à un monorepo JavaScript ou TypeScript existant en une après-midi. Vous définissez un pipeline dans turbo.json décrivant les dépendances entre tâches (build dépend de lint, test dépend de build), et Turborepo calcule un hash du contenu des entrées de chaque tâche — fichiers source, variables d'environnement déclarées explicitement, et sorties des tâches précédentes — pour décider s'il faut l'exécuter ou la restaurer depuis le cache.
Le piège se trouve dans ce mot « explicitement ». La justesse du cache de Turborepo dépend du fait que vous déclariez chaque entrée affectant la sortie d'une tâche, y compris les variables d'environnement. En oubliez-vous une — un feature flag, une URL de base d'API intégrée au moment du build — Turborepo restaurera avec une confiance totale un build mis en cache obsolète qui ne reflète pas la sortie réelle pour la nouvelle valeur de cette variable d'environnement. Ce n'est pas un bug ; c'est le compromis d'un outil léger qui ne place pas les builds dans un bac à sable. Les équipes qui adoptent Turborepo puis se font piéger par cela réagissent généralement en surdéclarant les entrées, ce qui érode discrètement le taux de succès du cache qui était pourtant tout l'intérêt de son adoption.
Nx : un graphe de dépendances réellement interrogeable, plus le même compromis de cache
Nx partage le modèle de cache par hash de contenu de Turborepo — la même force, la même faiblesse liée aux entrées explicites — mais ajoute une fonctionnalité qui devient plus importante à mesure qu'un dépôt grandit : un graphe de projet réel et interrogeable. Les commandes nx graph et nx affected vous permettent de demander « quels projets ce changement touche-t-il réellement » et d'exécuter les tâches uniquement pour le sous-ensemble affecté, ce que Turborepo peut approximer via ses propres déclarations de dépendances mais sans l'exposer de la même manière comme un graphe de première classe et inspectable.
Cela compte concrètement à l'échelle de la CI : un monorepo de 150 paquets où une seule PR ne touche que deux d'entre eux ne devrait pas déclencher une exécution de tests sur l'ensemble du dépôt. Le modèle de graphe affecté de Nx, combiné à l'exécution distribuée des tâches sur des agents CI, est précisément construit autour de ce problème. Le point de comparaison honnête est que la justesse du cache de Nx souffre du même piège lié aux variables d'environnement que Turborepo — c'est le même modèle de confiance sous-jacent, simplement avec une meilleure interface pour comprendre ce que contient votre graphe de dépendances.
Bazel : les builds hermétiques résolvent le problème de justesse, à un coût réel
Bazel adopte une approche fondamentalement différente, et c'est celle qui résout réellement le problème de justesse du cache plutôt que de simplement l'atténuer. Les builds Bazel s'exécutent dans un bac à sable sans accès au système de fichiers ambiant ni à l'environnement au-delà de ce qui est explicitement déclaré comme entrée — un build Bazel ne peut véritablement pas dépendre silencieusement d'une variable d'environnement que vous avez oublié de déclarer, car le bac à sable ne l'expose pas. C'est ce que Bazel appelle un build hermétique, et c'est pourquoi Google, qui a rendu Bazel open source à partir de son système interne Blaze, fait confiance à la mise en cache des builds à l'échelle de milliards de lignes de code répartis entre des milliers d'ingénieurs.
Le coût est une friction d'adoption que Turborepo et Nx ont délibérément évitée. Bazel exige de décrire votre graphe de build dans son propre format de fichier BUILD (Starlark, un dialecte de Python), ce qui signifie envelopper les dépendances npm, pip ou Maven existantes via des règles spécifiques à Bazel (rules_js, rules_python, rules_jvm_external) plutôt que de simplement pointer Bazel vers votre package.json ou requirements.txt existant. Migrer un monorepo JavaScript existant de 100 paquets vers Bazel est généralement un projet de plusieurs mois, pas une après-midi. Les équipes qui font cet investissement sont généralement celles à qui des échecs de justesse dus à un mauvais cache ont déjà coûté quelque chose — un build publié ayant silencieusement utilisé du code obsolète — ou dont l'échelle de build (milliers de cibles, exécution distante sur une ferme de build) a dépassé ce qu'un outil non hermétique peut garantir.
Choisir entre ces outils
La décision n'est pas vraiment « quel outil est le plus rapide » — les trois sont suffisamment rapides pour qu'un succès de cache paraisse instantané. C'est une question de mode de défaillance que vous pouvez tolérer et de douleur de migration que vous pouvez absorber :
- Choisissez Turborepo si vous avez un monorepo JS/TS existant de moins d'une cinquantaine de paquets, que vous voulez une mise en cache opérationnelle d'ici la fin de la semaine, et que vous êtes prêt à assumer la discipline de déclarer explicitement chaque entrée (et de l'auditer quand quelque chose semble obsolète).
- Choisissez Nx si vous avez dépassé cette taille, que vous avez besoin du modèle de graphe affecté pour des temps de CI raisonnables, et que vous voulez des outils de générateurs/plugins pour créer de nouveaux paquets de façon cohérente — en acceptant la même discipline de déclaration des entrées qu'exige Turborepo.
- Choisissez Bazel si vous avez déjà été victime d'un bug de cache obsolète ayant atteint la production, si vous êtes polyglotte (Java, Go, Python et JS dans un même dépôt), ou si l'échelle de votre CI nécessite réellement une exécution distante sur une ferme de build plutôt qu'un simple cache distant partagé — et que vous pouvez doter la migration en personnel.
Un bon test pratique avant de s'engager : cherchez la dernière fois où votre équipe a publié un build ayant silencieusement utilisé un artefact obsolète. Si cela n'est jamais arrivé, le modèle plus léger de Turborepo ou Nx est probablement le bon compromis. Si cela s'est produit plus d'une fois, c'est exactement là que le bac à sable hermétique de Bazel justifie son propre coût de migration.