Урок 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"]
}Документация
Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.