Générateur de fichier tsconfig.json
Guide
Générateur de fichier tsconfig.json
Générer un fichier valide tsconfig.json pour les projets TypeScript sans devoir mémoriser les noms des options ou chercher dans les notes de version pour savoir ce qui a changé dans la dernière version du compilateur. Choisissez un profil (Node ESM, Node CommonJS, React, Next.js, Bibliothèque, ou le plus strict), ajustez les commutateurs de stricteur, ajoutez les alias de chemin si nécessaire, puis copiez le JSON généré dans le répertoire racine de votre projet.
La configuration du compilateur TypeScript est une surface très pointue : les noms des options sont sensibles à la casse, la liste augmente à chaque mise à jour, et une clé mal orthographiée ou dépréciée peut produire un résultat erroné sans échec rapide. Un générateur basé sur un formulaire qui ne génère que les options cochées est la méthode la plus rapide pour obtenir une configuration fonctionnelle qui correspond à votre projet et à son pipeline de compilation.
Comment utiliser
- Ouvrez le Profil prédéfini menu déroulant et choisissez le meilleur match pour votre projet. Le formulaire remplit des valeurs sensibles pour la cible, le système de modules, le mode JSX et les indicateurs recommandés.
- Ajustez la Section Langage & Modules si votre environnement de runtime a besoin d'un autre
target,module, oumoduleResolution. Définissezjsxsi vous compilez React. - Définissez le Architecture du projet champs (
rootDir,outDir,baseUrl) pour correspondre à la structure de votre dossier. Ajoutez des alias de chemin un par ligne sous la formealias=target(par exemple@/*=src/*). - Utilisez le Stricteur et Vérification des cases à cocher pour activer des vérifications individuelles du compilateur.
strictactive la famille stricte complète en un clic. - Le Émission & Interop section contrôle la manière dont les fichiers sont produits et comment les imports par défaut fonctionnent. Activez
declarationpour les bibliothèques ounoEmitlorsque le bundler gère la sortie. - Copiez la configuration générée dans le panneau de sortie, ou téléchargez-la directement sous forme de
tsconfig.json.
Caractéristiques
- Profils prédéfinis – Node (ESM et CommonJS), React, Next.js App Router, Bibliothèque, et un profil le plus strict pour les nouveaux projets.
- Tous les versions cibles modernes – de ES5 à ES2023 plus ESNext, avec des systèmes de modules correspondants incluant NodeNext et la résolution du bundler.
- Construire les alias de chemin – Entrez un alias par ligne ; le générateur relie automatiquement
baseUrllorsque des alias sont présents. - Stricteur granulaire – Activez
noUncheckedIndexedAccess,exactOptionalPropertyTypeset d'autres indicateurs individuels de la famille stricte. - Support JSX – Choisissez entre
react-jsx,react-jsxdev, classiquereact, oupreservepour les bundlers. - Commentaires inline – Chaque option peut être annotée avec une courte explication afin que le fichier résultant se documente lui-même.
- Inclure et exclure les modèles glob – Entrée multi-ligne pour
includeetexcludeavec des valeurs par défaut sensibles selon le profil. - Mode bibliothèque – Le profil bibliothèque active
declaration,declarationMapetsourceMapafin que les consommateurs obtiennent des types complets. - Copier ou télécharger – Collez le résultat dans votre dépôt en un clic.
FAQ
-
Qu'est-ce que tsconfig.json et pourquoi TypeScript a-t-il besoin de ce fichier ?
tsconfig.json est le fichier de configuration que le compilateur TypeScript lit pour déterminer quels fichiers appartiennent à un projet et comment les compiler. Son existence dans un dossier marque ce dossier comme la racine d'un projet TypeScript. En l'absence de ce fichier, le compilateur fonctionne toujours pour des fichiers isolés, mais des outils comme les éditeurs, les pipelines de construction ou les intégrations de vérification du code dépendent de ce fichier pour partager une vue cohérente du code, du runtime cible et de la stricte vérification des types.
-
Quelle est la différence entre module et moduleResolution ?
module contrôle la syntaxe du JavaScript que TypeScript génère — CommonJS require/exports, des modules ES avec import/export, ou un mélange comme NodeNext. moduleResolution est indépendant et contrôle la recherche des spécificateurs import sur le disque — par exemple, si un import sans extension est résolu en un fichier .ts, si les champs d'exportations dans package.json sont pris en compte, et si un résolveur de type bundler est supposé. Les projets modernes utilisant un bundler associent généralement module : ESNext avec moduleResolution : Bundler ; les projets purs Node sans bundler associent module : NodeNext avec moduleResolution : NodeNext.
-
Qu'est-ce que strict active exactement ?
strict est un indicateur global qui active l'ensemble de la famille stricte en un seul paramètre : noImplicitAny, strictNullChecks, strictFunctionTypes, strictBindCallApply, strictPropertyInitialization, noImplicitThis, alwaysStrict, et useUnknownInCatchVariables. Les nouveaux indicateurs strict ajoutés dans les versions futures du compilateur sont également inclus automatiquement. Les indicateurs individuels peuvent encore être définis explicitement pour surcharger la valeur par défaut de strict, mais la plupart des nouveaux projets devraient laisser strict activé et ajouter des options plus strictes comme noUncheckedIndexedAccess en complément.
-
Comment les alias de chemin fonctionnent-ils avec baseUrl ?
paths définit une correspondance entre des spécificateurs d'import et des emplacements de fichiers réels, et la recherche se fait par rapport à baseUrl. Par exemple, baseUrl : "." et paths : { "@/*" : ["src/*"] } signifie qu'un import depuis @/utils se résout à ./src/utils. Les alias de chemin n'affectent que la vérification des types ; les bundlers, les exécutants de tests et le runtime ont besoin de leur propre configuration équivalente (Vite resolve.alias, Jest moduleNameMapper, champ imports de Node) pour que les mêmes chemins fonctionnent au niveau du runtime.
-
Dans quels cas doit-on activer noEmit ?
noEmit est destiné aux projets où un autre outil — généralement un bundler comme Vite, esbuild, webpack ou Next.js — produit la sortie en JavaScript, et où TypeScript est utilisé uniquement pour la vérification des types. Avec noEmit activé, le compilateur vérifie les types mais ne génère aucun fichier. Il est également utile dans les environnements de CI pour une étape rapide de vérification des types. Pour les projets de bibliothèques publiés sur npm, laissez noEmit désactivé afin que le compilateur puisse générer des fichiers .js et .d.ts en parallèle des sources.
Installez nos extensions
Ajoutez des outils IO à votre navigateur préféré pour un accès instantané et une recherche plus rapide
恵 Le Tableau de Bord Est Arrivé !
Tableau de Bord est une façon amusante de suivre vos jeux, toutes les données sont stockées dans votre navigateur. D'autres fonctionnalités arrivent bientôt !
Outils essentiels
Tout voir Nouveautés
Tout voirMise à jour: Notre dernier outil a été ajouté le 16 juin 2026
