Formations — 1 037 leçons en français

Accueil › TypeScript › Chemins, projets et temps de compilation

Chemins, projets et temps de compilation

Configurer le compilateurintermediaire

paths ne déplace rien

{
  "compilerOptions": {
    "paths": { "@app/*": ["./src/*"] }
  }
}
import { Client } from "@app/clients";   // ✅ le compilateur trouve src/clients.ts

Le code produit garde la chaîne "@app/clients" telle quelle. Si le paquetteur, Node ou le lanceur de tests ne connaît pas le même alias, l'application échoue sur Cannot find module '@app/clients' alors que tsc --noEmit était vert.

Un alias se déclare donc deux fois : dans le tsconfig.json pour la vérification, et dans l'outil de construction pour l'exécution.

extends : l'enfant écrase le parent

// tsconfig.base.json
{ "compilerOptions": { "strict": true, "lib": ["ES2022", "DOM"] } }
// tsconfig.json
{ "extends": "./tsconfig.base.json", "compilerOptions": { "lib": ["ES2022"] } }

lib vaut ["ES2022"], pas l'union des deux. Les tableaux ne fusionnent pas.

Les chemins relatifs d'un fichier hérité s'interprètent par rapport au fichier qui les déclare. Un outDir: "./dist" écrit dans le fichier de base désigne le dist voisin de ce fichier de base, pas celui de l'enfant.

Le temps de compilation

{
  "compilerOptions": {
    "incremental": true,
    "skipLibCheck": true
  }
}

incremental écrit un .tsbuildinfo et ne revérifie que ce qui a changé. skipLibCheck cesse de vérifier les .d.ts des dépendances. Au-delà, les projets composites découpent le dépôt en unités que tsc --build recompile séparément.

Les termes à connaître

baseUrl

Le répertoire à partir duquel les chemins non relatifs sont résolus. Avec paths seul, il n'est plus obligatoire depuis TypeScript 5.

paths

Une table d'alias d'import pour le compilateur. Elle ne déplace aucun fichier et n'a aucun effet à l'exécution.

extends

Fait hériter un tsconfig.json d'un autre. L'enfant écrase le parent clé par clé ; les tableaux ne fusionnent pas.

incremental

Écrit un fichier .tsbuildinfo qui permet au compilateur de ne revérifier que ce qui a changé.

skipLibCheck

Cesse de vérifier les fichiers .d.ts des dépendances. Le gain de temps est réel, le risque est de manquer un conflit de types.

Projet composite

Un projet déclaré composite: true et référencé par un autre. tsc --build ne recompile alors que les projets modifiés.

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.