Leggere il codice degli altri
Un approccio sistematico per capire qualsiasi codebase
⏱ Stima ~8 min
01 · Leggi
Il segreto che sorprende la maggior parte dei principianti: i professionisti leggono molto più codice di quanto ne scrivano.
Quando entri in un team, cambi progetto, o torni al tuo stesso codice dopo qualche settimana, devi capire codice che non hai scritto (o che non ricordi di aver scritto). Scorrere tutto sperando di capirci qualcosa non funziona. Ti serve un sistema.
La buona notizia? Leggere codice è un'abilità: più ti eserciti, più diventa facile. Impariamo un processo ripetibile che funziona con qualsiasi codebase.
💡 Immagina cosìLeggere una nuova codebase è come esplorare una nuova città. Non inizi a camminare a caso per le strade. Prima guardi la mappa (README), vedi cosa c'è intorno (dipendenze), trovi le strade principali (punti d'ingresso), poi esplori i quartieri uno per uno (moduli).
02 · Leggi
Hai appena ricevuto il progetto di qualcun altro — Task API. Non hai mai visto questo codice. Seguiamo il protocollo di lettura del codice nel terminale, passo dopo passo.
03 · Pratica nel terminale
Protocollo di lettura del codice — Passo 1: leggi il README. Il README spiega cosa fa il progetto, come installarlo e come eseguirlo. Comincia sempre da qui.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
04 · Pratica nel terminale
Passo 2: leggi package.json. Le dipendenze ti dicono quali tecnologie vengono usate. Gli script ti dicono come eseguire e testare il progetto.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
05 · Pratica nel terminale
Passo 3: trova il punto d'ingresso e scansiona la struttura. Dal package.json sai che app.js è il punto d'ingresso. Prima osserva la struttura delle cartelle, poi leggi il file principale.
(Questa sezione è interattiva — attiva JavaScript per usarla.)
06 · Passo dopo passo
Protocollo di lettura del codice — segui questi passi con ogni nuova codebase
1. Leggi il README
README.md ti dice cosa fa il progetto, come installarlo e come eseguirlo. Inizia sempre da qui. Anche l'assenza di un README dice qualcosa — probabilmente la documentazione è scarsa.
2. Leggi package.json
Le dipendenze ti dicono quali tecnologie vengono usate. Gli script ti dicono come eseguire e testare. Guarda "dependencies" per le librerie principali, e "scripts" per comandi come "start", "test", "build".
3. Scansiona la struttura delle cartelle
Come è organizzato il codice? Guarda src/, public/, routes/, models/ — suggeriscono l'architettura. Una struttura piatta con tutto in una cartella indica un progetto piccolo. Cartelle annidate con nomi chiari indicano una buona organizzazione.
4. Trova il punto d'ingresso
Di solito index.js, app.js o main.js — da qui parte il programma. Il campo "main" in package.json o lo script "start" ti indicano dove guardare.
5. Segui gli import
Dal punto d'ingresso, segui le istruzioni require() o import per capire l'albero delle dipendenze. Ogni import ti porta al pezzo successivo del puzzle. Non cercare di capire tutto in una volta — prima mappa le connessioni.
6. Chiedi aiuto a Claude
Con Claude Code: "dammi una panoramica di questo progetto" — otterrai subito un riepilogo ad alto livello. Claude può leggere ogni file e in pochi secondi ti restituisce una mappa della codebase — quello che a mano ti richiederebbe ore.
07 · Completa
Quando esplori un nuovo progetto, il primo file da leggere è _____.
08 · Quiz
Quando esplori una nuova codebase, cosa devi leggere per prima cosa?
- Il file più grande del progetto
- Il file README.md
- Ogni file JavaScript dall'inizio alla fine
- I file di test
Altre lezioni di questo capitolo
⚠ L'esperienza interattiva completa richiede JavaScript. Attivalo e ricarica la pagina.
※ Questo è un progetto educativo indipendente — non è un prodotto ufficiale di Anthropic. Claude™ è un marchio di Anthropic, PBC.