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
pathsseul, 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.jsond'un autre. L'enfant écrase le parent clé par clé ; les tableaux ne fusionnent pas.- incremental
Écrit un fichier
.tsbuildinfoqui permet au compilateur de ne revérifier que ce qui a changé.- skipLibCheck
Cesse de vérifier les fichiers
.d.tsdes 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: trueet référencé par un autre.tsc --buildne recompile alors que les projets modifiés.
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.