0Pricing
TypeScript Academy · Lezione

Monorepo e Project References

Crei un monorepo workspace e colleghi i Project References di TypeScript per build rapide e incrementali e tipi puliti tra i pacchetti.

Monorepo e Project References è una lezione TypeScript Academy gratuita su CoddyKit. Questa è la lezione 1 di 1. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento TypeScript Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso TypeScript Academy include 1 lezioni in totale.

Introduzione

Obiettivo: organizzare un monorepo che possa crescere. Dichiarerà i workspace, aggiungerà i Project References e creerà la build con tsc -b per ottenere un output incrementale.

  • Workspace pnpm/yarn
  • Progetti compositi
  • Tipi condivisi

Struttura del workspace

Un semplice layout composto da due pacchetti: shared (libreria) e app (che dipende da shared). I workspace collegano i pacchetti locali.

# 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 radice

Dichiari i workspace affinché il gestore dei pacchetti colleghi le dipendenze locali. Aggiunga gli script build/clean usando la modalità di build di TS.

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

Pacchetto shared

Contrassegni la libreria come progetto composite. Generi le dichiarazioni affinché i pacchetti dipendenti possano verificare rapidamente i tipi.

// 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}`

Pacchetto app + riferimenti

Aggiunga una voce references per dichiarare la dipendenza da shared. Il builder compila prima shared, quindi 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" }))

Configurazione di base e suggerimenti

Suggerimenti:

  • Crei tsconfig.base.json per le opzioni del compilatore condivise.
  • Usi mappature paths che rispecchino i nomi dei pacchetti.
  • Esegua tsc -b --watch per lo sviluppo locale incrementale.

Verifica dei requisiti dei riferimenti

Verifica rapida: che cosa deve includere ogni pacchetto referenziato?

Riepilogo

Riepilogo: i workspace collegano i pacchetti locali; Project References (composite + references) consentono build tsc -b rapide e incrementali, oltre a tipi affidabili tra pacchetti.

Domande Frequenti

La lezione «Monorepo e Project References» è gratuita?

Sì — il testo completo di «Monorepo e Project References» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso TypeScript Academy, passa a CoddyKit PRO. Il corso TypeScript Academy include 1 lezioni in totale.

Cosa imparerò in «Monorepo e Project References»?

Crei un monorepo workspace e colleghi i Project References di TypeScript per build rapide e incrementali e tipi puliti tra i pacchetti. Eserciti TypeScript Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare TypeScript Academy?

Non è richiesta alcuna esperienza precedente. TypeScript Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 1 di 1.

Quanto tempo richiede la lezione «Monorepo e Project References»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione TypeScript Academy?

Sì. Ogni lezione TypeScript Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

← Torna a TypeScript Academy