Creare un progetto
Configurare un vero progetto Node.js da zero
⏱ Stima ~9 min
01 · Leggi
Ogni software che hai usato — dalle app per telefono ai grandi siti web — è iniziato così: qualcuno ha creato una cartella vuota e configurato un progetto al suo interno. È quello che farai adesso.
Configurare bene il progetto fin dall'inizio ti risparmia tanti grattacapi dopo. In Node.js un progetto non è niente di speciale — è solo una cartella con un file di configurazione package.json che tiene traccia del nome, della versione e delle dipendenze del progetto. Senza questo file, strumenti come npm non sanno cosa serve al tuo progetto o come eseguirlo.
Immaginalo come trasferirsi in un nuovo appartamento. Prima di arredarlo o invitare amici, devi firmare il contratto e prendere le chiavi. npm init è come firmare il contratto — crea il documento ufficiale (package.json) che dice 'questa cartella è un vero progetto'.
💡 Immagina cosìAvviare un progetto è come trasferirsi in un nuovo appartamento. Prima di arredarlo o costruirci qualcosa, devi firmare il contratto (npm init) e ottenere il documento ufficiale che lo rende valido (package.json).
Punti chiave
- Ogni progetto Node.js inizia con una cartella e un package.json
- package.json tiene traccia dell'identità e delle dipendenze del progetto
- Configurare tutto bene dall'inizio evita confusione quando il progetto cresce
02 · Pratica reale
Ogni progetto inizia con una cartella. Creane una chiamata my-server ed entra al suo interno. Questi due comandi creano la directory e ci entrano.
mkdir my-server && cd my-server
03 · Pratica reale
Ora inizializza il progetto con npm. Il flag -y significa "usa tutti i default" — salta le domande e crea subito il file di configurazione.
npm init -y
04 · Quiz
Cosa fa il flag -y in npm init -y?
- Installa l'ultima versione di npm
- Crea un file yarn.lock
- Salta tutte le domande e usa i valori di default
- Yes, elimina i file esistenti
05 · Pratica reale
Vediamo cosa ha creato npm. Il package.json è il cuore di ogni progetto Node.js — descrive il tuo progetto e tiene traccia delle dipendenze.
cat package.json
06 · Completa
Il file che tiene traccia delle dipendenze del tuo progetto si chiama _____.
07 · Leggi
Cosa significa ogni campo in package.json:- name — il nome del tuo progetto (di default è il nome della cartella) - version — il numero di versione del progetto (parte da 1.0.0) - description — una breve descrizione di cosa fa il progetto - main — il file di ingresso (il file eseguito quando qualcuno importa il tuo progetto) - scripts — comandi personalizzati eseguibili con npm run <nome> - keywords — tag di ricerca se pubblichi su npm - license — come altri possono usare il tuo codice
Il campo più importante che userai presto è dependencies — elenca ogni pacchetto di cui il progetto ha bisogno. Per ora è vuoto perché non abbiamo ancora installato niente.
Punti chiave
- package.json è il file di configurazione di ogni progetto Node.js
- npm init -y lo crea con valori di default sensati
- Il campo dependencies tiene traccia dei pacchetti usati dal progetto
08 · Quiz
Provi a eseguire npm install express ma va in errore dicendo che non c'è package.json. Cosa devi fare prima?
- Reinstallare Node.js
- Creare manualmente un file chiamato express.js
- Eseguire node install express invece
- Eseguire npm init -y per creare il file package.json
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.