0Pricing
TypeScript Academy · Урок

Импорты и экспорты только типов

Используйте import type, чтобы избежать затрат во время выполнения

«Импорты и экспорты только типов» — бесплатный урок TypeScript Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения TypeScript Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс TypeScript Academy содержит 4 уроков всего.

Добро пожаловать

Импорты и экспорты только типов (import type / export type) появились в TypeScript 3.8, чтобы дать разработчикам явный контроль над тем, что является зависимостью времени выполнения, а что — только типом.

Почему важны импорты только типов

Обычные импорты могут включать код, выполняемый во время работы. Если нужен только тип, импорт можно полностью удалить из скомпилированного результата.
import { User } from './models'; // includes runtime binding
import type { User } from './models'; // compile-time only, erased

Синтаксис import type

Поместите `type` после ключевого слова `import`. Импортированное имя нельзя использовать как значение.
import type { ApiResponse } from './api-types';

function handleResponse(res: ApiResponse<User>): void {
  // ApiResponse used as type annotation only
}

Синтаксис export type

Используйте `export type`, чтобы явно обозначить экспорт как экспорт только типа.
// user.types.ts
export type UserId = string;
export type { User, UserRole };

Встроенный импорт типа

TypeScript 4.5+ позволяет помечать отдельные импорты как импорты только типов внутри обычной инструкции импорта.
import { type User, createUser } from './user';
// User is type-only, createUser is a runtime value

Разрешение циклических зависимостей

Импорты только типов могут устранить проблемы с циклическими зависимостями, поскольку они не создают привязки времени выполнения.

verbatimModuleSyntax

В TypeScript 5.0 появился `verbatimModuleSyntax`. Если он включён, вы MUST использовать `import type` для импортов только типов, чтобы избежать путаницы в сборщике.
// tsconfig.json
{ "compilerOptions": { "verbatimModuleSyntax": true } }

importsNotUsedAsValues

Параметр компилятора `importsNotUsedAsValues` (заменённый на verbatimModuleSyntax) управляет обработкой TypeScript неиспользуемых импортов значений.

Преимущества для сборщиков

Сборщики, такие как Vite и esbuild, используют пометки `import type`, чтобы пропускать обработку импортов типов и ускорять сборку.

Переэкспорты только типов

Повторно экспортируйте типы без включения их модуля времени выполнения.
// public-api.ts
export type { User, UserRole } from './internal-user';
export { createUser } from './internal-user'; // runtime

Ошибка: import type нельзя использовать как значение

Использование импорта только типа как значения времени выполнения приводит к ошибке компиляции.
import type { User } from './user';
// const u = new User(); // Error — User was imported as type-only

Быстрая проверка

Когда следует использовать `import type` вместо обычного `import`?

Итоги

Используйте `import type` и `export type` для импорта и экспорта только типов. Они удаляются во время компиляции, предотвращают зависимость времени выполнения от файлов типов и обязательны при включённом verbatimModuleSyntax.

Часто задаваемые вопросы

Урок «Импорты и экспорты только типов» бесплатный?

Да — полный текст урока «Импорты и экспорты только типов» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс TypeScript Academy, подпишись на CoddyKit PRO. Курс TypeScript Academy содержит 4 уроков всего.

Чему я научусь в уроке «Импорты и экспорты только типов»?

Используйте import type, чтобы избежать затрат во время выполнения Ты практикуешь TypeScript Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать TypeScript Academy?

Предыдущий опыт не требуется. TypeScript Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Импорты и экспорты только типов»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке TypeScript Academy?

Да. Каждый урок TypeScript Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Синтаксис модулей ES: import и export
  2. Повторные экспорты и файлы-агрегаторы
  3. Импорты и экспорты только типов
  4. Пространства имён и модули: современное применение
← Назад к TypeScript Academy