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 :
includetrop large — les fichiers de test, lesdist, lesnode_modulesentrent dans le programme.- Pas d'
incremental— chaque compilation revérifie tout. - Un seul projet monolithique — un fichier modifié fait tout reconstruire.
- 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
--extendedDiagnosticsdé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
.tsbuildinfopour 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
referencesdanstsconfig.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.
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.