TypeScript Academy · Lekcja

Importy i eksporty tylko typów

Używaj import type, aby uniknąć narzutu w czasie działania.

Lekcja 3 z 413 kroki

Importy i eksporty tylko typów to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 3 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej TypeScript Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Wprowadzenie

Importy i eksporty wyłącznie typów (import type / export type) wprowadzono w TypeScript 3.8, aby dać programistom jawną kontrolę nad tym, co jest zależnością wykonywaną w czasie działania, a co tylko typem.

Dlaczego importy wyłącznie typów mają znaczenie

Zwykłe importy mogą zawierać kod wykonywany w czasie działania. Jeśli potrzebny jest tylko typ, import można całkowicie usunąć ze skompilowanego wyniku.
import { User } from './models'; // includes runtime binding
import type { User } from './models'; // compile-time only, erased

Składnia import type

Umieść `type` za słowem kluczowym `import`. Zaimportowanej nazwy nie można używać jako wartości.
import type { ApiResponse } from './api-types';

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

Składnia export type

Użyj `export type`, aby jawnie oznaczyć eksporty jako dotyczące wyłącznie typów.
// user.types.ts
export type UserId = string;
export type { User, UserRole };

Wbudowany import typu

TypeScript 4.5+ pozwala oznaczać pojedyncze importy jako dotyczące wyłącznie typów w ramach zwykłej instrukcji importu.
import { type User, createUser } from './user';
// User is type-only, createUser is a runtime value

Rozwiązywanie cyklicznych zależności

Importy wyłącznie typów mogą rozwiązać problemy z cyklicznymi zależnościami, ponieważ nie tworzą wiązań wykonywanych w czasie działania.

verbatimModuleSyntax

TypeScript 5.0 wprowadził `verbatimModuleSyntax`. Po włączeniu tej opcji MUSISZ używać `import type` dla importów wyłącznie typów, aby uniknąć niejasności po stronie bundlera.
// tsconfig.json
{ "compilerOptions": { "verbatimModuleSyntax": true } }

importsNotUsedAsValues

Opcja kompilatora `importsNotUsedAsValues` (zastąpiona przez verbatimModuleSyntax) określa sposób obsługi przez TypeScript nieużywanych importów wartości.

Korzyści w bundlerach

Bundlery takie jak Vite i esbuild używają znaczników `import type`, aby pomijać przetwarzanie importów typów, co zwiększa szybkość kompilacji.

Ponowne eksporty wyłącznie typów

Ponownie eksportuj typy bez dołączania ich modułu wykonywanego w czasie działania.
// public-api.ts
export type { User, UserRole } from './internal-user';
export { createUser } from './internal-user'; // runtime

Błąd: nie można użyć import type jako wartości

Użycie importu wyłącznie typu jako wartości wykonywanej w czasie działania powoduje błąd kompilacji.
import type { User } from './user';
// const u = new User(); // Error — User was imported as type-only

Szybkie sprawdzenie

Kiedy należy użyć `import type` zamiast zwykłego `import`?

Podsumowanie

Używaj `import type` i `export type` do importów i eksportów wyłącznie typów. Są usuwane podczas kompilacji, zapobiegają powstawaniu wykonywanej w czasie działania zależności od plików typów i są wymagane po włączeniu verbatimModuleSyntax.
Bezpłatny start

Ucz się TypeScript dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy
101
Lekcje
352

Często zadawane pytania

Czy lekcja „Importy i eksporty tylko typów” jest bezpłatna?

Tak — pełny tekst „Importy i eksporty tylko typów” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu TypeScript Academy, przejdź na CoddyKit PRO. Kurs TypeScript Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Importy i eksporty tylko typów”?

Używaj import type, aby uniknąć narzutu w czasie działania. Ćwiczysz TypeScript Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć TypeScript Academy?

Nie wymagamy żadnego doświadczenia. TypeScript Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 3 z 4.

Ile czasu zajmuje lekcja „Importy i eksporty tylko typów”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji TypeScript Academy?

Tak. Każda lekcja TypeScript Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

  1. Składnia modułów ES: import i export
  2. Ponowne eksporty i pliki zbiorcze
  3. Importy i eksporty tylko typów
  4. Przestrzenie nazw a moduły: współczesne zastosowanie
← Powrót do TypeScript Academy