TypeScript 6.0: что изменилось и как обновить tsconfig без боли

TypeScript 6.0 — это не просто очередная мажорная версия с галочкой в changelog. Здесь есть реальные breaking changes, которые затрагивают конфигурацию компилятора и могут сломать сборку там, где ты этого совсем не ждёшь.

Что изменилось в компиляторе

В 6.0 команда TypeScript продолжила курс на более строгое и предсказуемое поведение. Ряд опций, которые раньше работали «по умолчанию мягко», теперь либо ведут себя иначе, либо требуют явного указания в конфиге.

Ключевые направления изменений:

• Разрешение модулей — поведение moduleResolution стало строже; старые значения вроде node могут давать неожиданные результаты в современных проектах
• verbatimModuleSyntax — набирает вес как рекомендуемый подход к импортам; влияет на то, как TypeScript обрабатывает import type
• isolatedModules — связанные изменения делают поведение более консистентным с бандлерами типа esbuild и Vite
• Строгость по умолчанию — некоторые проверки, которые раньше нужно было включать вручную, теперь активны в новых проектах из коробки

Как привести tsconfig в порядок

Перед обновлением пакета стоит пройтись по конфигу вручную. Вот практический чеклист:

1. Проверь moduleResolution — для современных проектов рекомендуется bundler или node16/nodenext, а не просто node
2. Явно укажи module — значение должно соответствовать твоему окружению; ESNext для бандлеров, CommonJS для Node.js без ESM
3. Добавь verbatimModuleSyntax: true — если используешь бандлер, это уберёт целый класс потенциальных проблем с импортами
4. Проверь target — убедись, что он актуален; ES2022 или выше разумен для большинства современных проектов
5. Удали устаревшие опции — часть флагов в 6.0 устарела или изменила семантику; tsc --showConfig поможет увидеть, что реально применяется

Практический совет по миграции

Если проект большой, не обновляй TypeScript и конфиг одновременно. Сначала обнови пакет, запусти tsc --noEmit и посмотри на ошибки — они покажут, где конфиг расходится с новым поведением компилятора.

Ошибки компилятора после мажорного обновления — это не баги, это документация. Читай их внимательно.

Отдельно стоит проверить paths и baseUrl — в связке с новым разрешением модулей они могут вести себя неожиданно, особенно если проект использует монорепо или нестандартную структуру.

Итого

TypeScript 6.0 делает компилятор более предсказуемым — но за это придётся заплатить явностью конфигурации. Зато после миграции сборка будет работать именно так, как написано в конфиге, а не «примерно так, как ты думал».