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

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

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

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

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

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