re:re:actable
Урок 041 минута чтения

Что такое tsconfig.json?

На этой странице
Кратко

tsconfig.json - файл настроек TypeScript-проекта: какие файлы проверять и как компилировать код.

Вопрос

Для чего нужен tsconfig.json?

Определение

tsconfig.json сообщает TypeScript-компилятору, где находится проект и какие правила проверки использовать. В нем задают compilerOptions, список файлов, исключения и особенности сборки.

Если в папке есть tsconfig.json, TypeScript воспринимает ее как корень проекта.

Пример

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "strict": true,
    "noEmit": true
  },
  "include": ["src"]
}

Частые поля

ПолеЧто делает
targetверсия JavaScript на выходе
moduleформат модулей
strictвключает строгие проверки
noEmitпроверять типы без генерации JS
includeкакие файлы включить
excludeкакие файлы исключить

strict

{
  "compilerOptions": {
    "strict": true
  }
}

Для обучения и серьезных проектов лучше привыкать к strict: true.

Что важно помнить

  • Ключевые опции: strict, target, module, moduleResolution, lib, jsx, paths, noEmit.
  • Для проектов на Vite и Next.js обычно используют moduleResolution: "bundler" и noEmit: true.
  • paths настраивает алиасы (@/*) только для компилятора — сборщику их нужно задать отдельно.
  • Общие настройки выносят в базовый конфиг и подключают через extends, например @tsconfig/strictest.

Мини-шпаргалка

{
  "compilerOptions": {
    "strict": true
  },
  "include": ["src"]
}

Документация

TypeScript: TSConfig Reference, TSConfig bases.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам