Что такое…

interface или type в TypeScript — что выбрать, и почему два interface сливаются молча

Иллюстрация: к одному силуэту подклеивают кусок, второй запечатан и ветвится

Открываешь проект, который тебе собрал ИИ. В одном файле interface User, в соседнем type Product. Выглядят почти одинаково. Возникает честный вопрос: это два разных инструмента или модель просто пишет как попало?

Ответ неожиданный даже для тех, кто давно на TypeScript: в девяти случаях из десяти разницы нет вообще. А в десятом она такая, что можно час искать, откуда у объекта взялось лишнее поле. Разберёмся, где проходит граница.

Что это такое

И то и другое описывает форму данных. Какие поля есть у объекта и какого они типа:

interface User {
  name: string;
  age: number;
}

type User = {
  name: string;
  age: number;
};

Эти две записи делают одно и то же. Редактор одинаково подсветит, если забудешь age или положишь туда строку. При запуске обе исчезают без следа — это подсказки для редактора, а не код. Если сама идея типов пока в новинку, начни со сравнения TypeScript и JavaScript.

Почему ИИ пишет то так, то эдак? Модели учились на миллионах чужих проектов, а там встречается и то и другое. Если в правилах проекта не сказано, что выбирать, агент берёт то, что ему ближе в эту секунду. Каждый файл по отдельности правильный, а проект в целом — лоскутное одеяло.

Разница — в краях.

Разбор по критериям

Описать объект. Оба справляются одинаково. Ничья.

Варианты «одно из». Роль пользователя — "guest", "member" или "admin". Это умеет только type:

type Role = "guest" | "member" | "admin";

У interface так нельзя — он описывает только объекты. Здесь type выигрывает, и это частый случай: такие списки вариантов заменяют enum.

Расширение. Нужен «админ» — это «пользователь» плюс права. Оба умеют:

interface Admin extends User { rights: string[] }
type Admin = User & { rights: string[] };

extends читается как обычный русский: «админ расширяет пользователя». Ошибки при конфликте полей у него понятнее. Небольшое очко в пользу interface.

Повторное объявление. Вот та самая ловушка. Объяви interface User дважды — в разных местах проекта:

interface User { name: string }
interface User { email: string }

Ошибки не будет. TypeScript молча склеит их в один: теперь у User два обязательных поля. Это называется слиянием объявлений. Библиотеки используют его нарочно — чтобы ты мог дописать поле в их тип. Но если это случайность, у тебя вдруг начинает требоваться email там, где ты его не ждал. С type такое невозможно: второе объявление с тем же именем — сразу ошибка «Duplicate identifier».

Что советует документация. Официальный справочник TypeScript пишет прямо: выбирай по вкусу, а если нужно правило — бери interface, пока не понадобятся возможности type.

Кому что подойдёт

Прямой ответ, без «зависит от задачи».

  • Описываешь объект — пользователь, товар, ответ API: interface. Так советует документация, так выглядит большинство кода в сети, и модели его хорошо понимают.
  • Список вариантов, сочетание типов, «или то, или это»: type. Другого выбора нет.
  • Проект уже написан в одном стиле — продолжай в нём. Единообразие важнее, чем «правильный» выбор.

Что точно не стоит делать — оставлять хаос, где рядом лежат interface User и type UserData для одного и того же. Когда читаешь код, написанный ИИ, такой дубль — сигнал, что агент правил проект кусками и не видел целого.

Одна фраза в правилах проекта наводит порядок:

Слабый промптИспользуй нормальные типы
Сильный промптВ этом проекте: формы объектов описываем через interface, варианты и объединения — через type. Не объявляй один и тот же interface дважды. Если нужный тип уже есть в src/types, импортируй его, а не создавай новый.

Что быстрее — interface или type?

Для работы приложения — одинаково: при запуске оба стираются. Для самого редактора на очень больших проектах расширение через extends проверяется быстрее, чем склейка через &, — об этом пишет команда TypeScript. Но новичку разницу не заметить.

Можно ли из type сделать interface и наоборот?

Да. interface может расширять type, если тот описывает объект. А type может включить interface через &. Смешивать можно — только держи правило, где что используешь.

А в обычном JavaScript это есть?

Нет. interface и type — чисто TypeScript. В JavaScript форму данных описывают комментариями JSDoc или не описывают вовсе.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →