5 ошибок в tsconfig, из-за которых TypeScript тормозит сборку и прячет баги

5 ошибок в tsconfig, из-за которых TypeScript тормозит сборку и прячет баги

Чаще всего проблемы не в самом TypeScript, а в том, как собран tsconfig. Типовая ошибка — держать один общий файл на весь репозиторий и ждать, что он одинаково хорошо подойдет для app, tests и build.

— strict: false или набор «полусырых» флагов. В итоге типы выглядят живыми, но часть ошибок уезжает в рантайм.
— skipLibCheck: true как постоянная настройка. Да, это ускоряет проверку, но еще и скрывает конфликты в типах зависимостей.
— Смешивание module, moduleResolution и ESM/CJS без явной цели. Потом ломаются импорты, path alias и тесты.

Отдельно проверь baseUrl и paths: они удобны в редакторе, но без зеркала в Vite, Vitest, Node и линтере превращаются в «работает только у меня». Еще одна ловушка — один include на все: в build попадают тесты, мокы и лишние декларации, а typecheck начинает шуметь и тормозить.

Хорошая схема простая: базовый tsconfig.base.json для общих правил, отдельные конфиги для app/test/build и минимум магии в alias. Тогда TypeScript быстрее, а ошибки видны там, где они реально важны.