0Pricing
TypeScript Academy · Lekcja

Przestrzenie nazw a moduły: współczesne zastosowanie

Dowiedz się, dlaczego moduły są preferowane zamiast przestrzeni nazw.

Przestrzenie nazw a moduły: współczesne zastosowanie to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 4 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.

Witamy

TypeScript początkowo oferował przestrzenie nazw (wcześniej nazywane „modułami wewnętrznymi”) do porządkowania kodu. Współczesny TypeScript korzysta zamiast tego z modułów ES. W tej lekcji wyjaśnimy, kiedy używać każdego z tych rozwiązań.

Czym jest przestrzeń nazw

Przestrzeń nazw to właściwy dla TypeScript sposób grupowania powiązanego kodu w nazwanym zakresie za pomocą słowa kluczowego `namespace`.
namespace Geometry {
  export interface Point { x: number; y: number; }
  export function distance(a: Point, b: Point): number {
    return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
  }
}

Dostęp do elementów przestrzeni nazw

Do elementów przestrzeni nazw można uzyskać dostęp za pomocą jej nazwy i notacji kropkowej.
const p1: Geometry.Point = { x: 0, y: 0 };
const p2: Geometry.Point = { x: 3, y: 4 };
const d = Geometry.distance(p1, p2); // 5

Zagnieżdżone przestrzenie nazw

Przestrzenie nazw można zagnieżdżać.
namespace App {
  export namespace Models {
    export interface User { name: string; }
  }
}
const u: App.Models.User = { name: 'Alice' };

Scalanie przestrzeni nazw

Przestrzenie nazw obsługują scalanie deklaracji — dwie deklaracje przestrzeni nazw o tej samej nazwie zostają scalone.
namespace Validation {
  export function validate(s: string): boolean { return s.length > 0; }
}
namespace Validation {
  export function sanitize(s: string): string { return s.trim(); }
}

Dlaczego preferowane są moduły

Moduły ES są standardem języka JavaScript. Są obsługiwane przez wszystkie bundlery, efektywnie podlegają usuwaniu nieużywanego kodu (tree shaking) i działają natywnie we współczesnych przeglądarkach oraz w Node.js.

Modułowy odpowiednik przestrzeni nazw

We współczesnym TypeScript przestrzeń nazw staje się po prostu plikiem. Należy eksportować to, co ma być publiczne, a resztę pozostawić prywatną.
// geometry.ts
export interface Point { x: number; y: number; }
export function distance(a: Point, b: Point): number {
  return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
}

Przestrzenie nazw nadal używane w plikach deklaracji

Przestrzenie nazw są nadal powszechnie używane w plikach deklaracji .d.ts dla bibliotek globalnych (takich jak typy DOM i typy Node.js), ponieważ rozszerzają zakres globalny.
// node.d.ts
declare namespace NodeJS {
  interface ProcessEnv { NODE_ENV?: 'development' | 'production'; }
}

Odwołania potrójnego ukośnika (starsze rozwiązanie)

Przed wprowadzeniem modułów ES dyrektywy potrójnego ukośnika służyły do odwoływania się do innych plików. Obecnie zastępują je `includes` w tsconfig oraz importy modułów.
/// <reference types="node" />
/// <reference path="./other.d.ts" />

Kiedy nadal używać przestrzeni nazw

Przestrzeni nazw należy używać: (1) w plikach deklaracji dla ambientowych typów globalnych, (2) podczas rozszerzania istniejących globalnych przestrzeni nazw pochodzących z bibliotek.

Migracja z przestrzeni nazw do modułów

Należy zastąpić `namespace Foo {}` plikiem modułu. `/// ` należy zastąpić importami. Zespół TypeScript udokumentował tę ścieżkę migracji.

Szybki sprawdzian

Jaki jest zalecany zamiennik przestrzeni nazw we współczesnym TypeScript?

Podsumowanie

Przestrzenie nazw porządkują kod w nazwanym zakresie, ale we współczesnym TypeScript są rozwiązaniem starszego typu. W kodzie aplikacji należy używać modułów ES (import/export). Przestrzenie nazw nadal są przydatne w plikach deklaracji do rozszerzania globalnych typów.

Często zadawane pytania

Czy lekcja „Przestrzenie nazw a moduły: współczesne zastosowanie” jest bezpłatna?

Tak — pełny tekst „Przestrzenie nazw a moduły: współczesne zastosowanie” 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 „Przestrzenie nazw a moduły: współczesne zastosowanie”?

Dowiedz się, dlaczego moduły są preferowane zamiast przestrzeni nazw. Ć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 4 z 4.

Ile czasu zajmuje lekcja „Przestrzenie nazw a moduły: współczesne zastosowanie”?

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