Formations — 1 037 leçons en français

Accueil › TypeScript › Tenir le temps de compilation

Tenir le temps de compilation

Migrer et tenir la compilationavance

Une compilation lente n'a presque jamais la cause qu'on lui prête. Quatre sources réelles, par ordre de fréquence :

  1. include trop large — les fichiers de test, les dist, les node_modules entrent dans le programme.
  2. Pas d'incremental — chaque compilation revérifie tout.
  3. Un seul projet monolithique — un fichier modifié fait tout reconstruire.
  4. Des types trop malins — conditionnels récursifs, gros types mappés, unions à plusieurs milliers de membres.

Le quatrième est celui qu'on accuse en premier, et c'est le plus rare.

Mesurer

tsc --noEmit --extendedDiagnostics
Files:                 2843
Types:               184022
Check time:            9.21s
Total time:           14.07s

Files: 2843 sur un projet de trois cents fichiers source désigne l'include. Un Check time élevé avec peu de fichiers désigne les types.

tsc --noEmit --generateTrace trace/

La trace s'ouvre dans un visualiseur de profil et nomme le fichier et le type qui coûtent. C'est la seule façon d'identifier un type coûteux ; le deviner ne marche pas.

Les trois réglages qui paient presque toujours

{
  "compilerOptions": {
    "incremental": true,
    "skipLibCheck": true
  },
  "include": ["src"],
  "exclude": ["**/*.test.ts", "dist"]
}

Mesurez d'abord. Le temps gagné par un réglage que vous n'avez pas mesuré est une hypothèse, pas un résultat.

Les termes à connaître

--diagnostics

Affiche le bilan d'une compilation. Sa variante --extendedDiagnostics détaille le temps passé par phase.

--generateTrace

Produit une trace lisible dans un visualiseur de profil, qui désigne le fichier et le type coûteux.

incremental

Écrit un fichier .tsbuildinfo pour ne revérifier que ce qui a changé. Sans lui, chaque compilation repart de zéro.

skipLibCheck

Saute la vérification de la cohérence interne des .d.ts. Gain réel sur les gros projets, au prix d'erreurs de déclarations non vues.

Projets référencés

references dans tsconfig.json : le projet est découpé, et chaque morceau se reconstruit seul.

isolatedModules

Interdit les constructions qu'un transpileur fichier par fichier ne peut pas traiter, ce qui autorise des outils de build beaucoup plus rapides.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.