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 коротких урока на телефоне.





