0Pricing
TypeScript Academy · Lekcja

Monorepo i Project References

Tworzenie monorepo workspace oraz konfigurowanie Project References TypeScript na potrzeby szybkich przyrostowych kompilacji i przejrzystych typów między pakietami

Monorepo i Project References to bezpłatna lekcja TypeScript Academy na CoddyKit. To lekcja 1 z 1. 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 1 lekcji w sumie.

Wprowadzenie

Cel: Zorganizować monorepo, które można skalować. Należy zadeklarować workspace'y, dodać Project References i budować za pomocą tsc -b, aby uzyskać przyrostowe wyniki.

  • Workspace'y pnpm/yarn
  • Projekty złożone
  • Współdzielone typy

Układ workspace'ów

Prosty układ dwóch pakietów: shared (biblioteka) i app (zależny od shared). Workspace'y łączą pakiety lokalne.

# folder structure (for reference)
			/monorepo
			package.json
			tsconfig.base.json
			packages/
			shared/
			src/index.ts
			package.json
			tsconfig.json
			app/
			src/index.ts
			package.json
			tsconfig.json

Workspace'y w katalogu głównym

Zadeklaruj workspace'y, aby menedżer pakietów łączył lokalne zależności. Dodaj skrypty build/clean, używając trybu kompilacji TS.

// package.json (root)
			{
			"name": "monorepo",
			"private": true,
			"workspaces": ["packages/*"],
			"scripts": {
			"build": "tsc -b packages/*",
			"clean": "tsc -b packages/* --clean"
			}
			}

Pakiet shared

Oznacz bibliotekę jako projekt composite. Generuj deklaracje, aby pakiety zależne mogły szybko sprawdzać typy.

// packages/shared/tsconfig.json
{
  "extends": "../../tsconfig.base.json",
  "compilerOptions": {
    "outDir": "dist",
    "rootDir": "src",
    "declaration": true,
    "composite": true
  },
  "include": ["src"]
}

// packages/shared/src/index.ts
export interface User { id: string; name: string }
export const hello = (u: User) => `Hello, ${u.name}`

Pakiet app + referencje

Dodaj wpis references, aby wskazać zależność od shared. Kompilator najpierw kompiluje shared, a następnie app.

// packages/app/tsconfig.json
			{
			"extends": "../../tsconfig.base.json",
			"compilerOptions": {
			"outDir": "dist",
			"rootDir": "src",
			"composite": true
			},
			"references": [
			{ "path": "../shared" }
			],
			"include": ["src"]
			}

			// packages/app/src/index.ts
		import { hello } from "shared"
console.log(hello({ id: "u1", name: "Ada" }))

Konfiguracja bazowa i wskazówki

Wskazówki:

  • Utwórz tsconfig.base.json dla wspólnych opcji kompilatora.
  • Używaj mapowań paths, które odzwierciedlają nazwy pakietów.
  • Uruchom tsc -b --watch na potrzeby przyrostowego programowania lokalnego.

Sprawdzenie wymagań referencji

Szybkie sprawdzenie: Co musi zawierać każdy pakiet, do którego istnieje referencja?

Podsumowanie

Podsumowanie: Workspace'y łączą pakiety lokalne; Project References (composite + references) umożliwiają szybkie, przyrostowe kompilacje za pomocą tsc -b oraz niezawodne typy między pakietami.

Często zadawane pytania

Czy lekcja „Monorepo i Project References” jest bezpłatna?

Tak — pełny tekst „Monorepo i Project References” 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 1 lekcji w sumie.

Co nauczysz się w „Monorepo i Project References”?

Tworzenie monorepo workspace oraz konfigurowanie Project References TypeScript na potrzeby szybkich przyrostowych kompilacji i przejrzystych typów między pakietami Ć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 1 z 1.

Ile czasu zajmuje lekcja „Monorepo i Project References”?

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.

← Powrót do TypeScript Academy