Cos’è npm? Una spiegazione del gestore di pacchetti di Node.js

Ogni progetto JavaScript moderno, frontend o backend, dipende da librerie di terze parti. Gestire manualmente queste dipendenze sarebbe un incubo. È qui che entra in gioco npm.

Cos’è npm?

Il Node Package Manager (npm) è il gestore di pacchetti predefinito di Node.js. Permette agli sviluppatori di:

• Installare librerie (pacchetti) dal registro npm pubblico.
• Gestire le dipendenze di un progetto tramite un file package.json.
• Pubblicare pacchetti personalizzati che altri possano usare.
• Controllare le versioni delle librerie e garantire compilazioni riproducibili con un lockfile (package-lock.json).

npm viene incluso automaticamente quando installi Node.js, quindi è il gestore di pacchetti più usato nell’ecosistema JavaScript.

Perché ci serve npm?

Le applicazioni JavaScript fanno ampio affidamento su moduli di terze parti, framework, componenti per interfacce, strumenti di compilazione, linter e altro. Senza un gestore di pacchetti come npm, gli sviluppatori dovrebbero scaricare e includere manualmente ogni dipendenza, tenere traccia delle versioni e gestire da soli le dipendenze annidate.

npm risolve questi problemi:

• Centralizzando la ricerca dei pacchetti in un unico registro.
• Garantendo una risoluzione coerente delle dipendenze tra gli ambienti.
• Automatizzando installazione, aggiornamenti e pubblicazione.
• Supportando script (npm run) per gestire attività di compilazione e distribuzione.

In breve: npm è la spina dorsale della gestione delle dipendenze JavaScript.

Alternative a npm

Sebbene npm sia l’opzione predefinita, sono emerse due alternative popolari:

• Yarn (di Meta), introdotto nel 2016 per migliorare prestazioni e affidabilità.
• pnpm, incentrato sull’efficienza nell’uso del disco e sulla velocità tramite storage indirizzabile per contenuto.

Ciascuno offre compromessi diversi a seconda delle dimensioni del progetto, del flusso di lavoro del team e della configurazione CI/CD.

Esempio reale: installare le dipendenze per un’app React

Supponiamo che tu stia preparando un nuovo progetto React:

npm install react react-dom
# or
yarn add react react-dom
# or
pnpm add react react-dom

Tutti e tre i comandi ottengono lo stesso risultato, aggiungere react e react-dom, ma differiscono per velocità, storage e struttura di node_modules.

npm

• Vantaggi

  • Ufficiale e supportato in modo più universale.
  • Forte integrazione con il registro npm.
  • Affidabile e in miglioramento a ogni versione.

• Svantaggi

  • Storicamente più lento (anche se molto migliorato dalla v7 in poi).
  • Crea alberi node_modules profondi e ridondanti (usa più disco).

• Prestazioni

  • Tempi di installazione moderati, con maggiore occupazione dello storage.

Yarn

• Vantaggi

  • Le installazioni parallele lo rendono più veloce delle vecchie versioni di npm.
  • Usa un lockfile deterministico (yarn.lock).
  • Ottime capacità di caching e funzionamento offline.

• Svantaggi

  • Due versioni principali con comportamenti diversi (v1 e Berry).
  • Problemi di compatibilità con alcuni script npm.

• Prestazioni

  • Leggermente più veloce di npm, con un uso moderato del disco.

pnpm

• Vantaggi

  • Lo storage basato su collegamenti simbolici riduce drasticamente l’uso del disco.
  • Installazioni molto rapide dopo la prima esecuzione (cache globale condivisa).
  • Il rigoroso isolamento delle dipendenze migliora la riproducibilità.

• Svantaggi

  • Un po’ meno comune nelle pipeline CI più vecchie.
  • Alcuni strumenti possono richiedere adattamenti della configurazione.

• Prestazioni

  • I tempi di installazione più rapidi e il minor uso del disco.

Confronto di prestazioni e storage

(🟢 = buono, 🟡 = medio, 🔴 = debole)

Comprendere ogni criterio

Velocità di installazione (a freddo)

Un’installazione a freddo significa installare pacchetti da zero, senza una cache già presente sul disco. Quando esegui:

npm install

su una macchina nuova o un runner di integrazione continua (CI) appena creato come GitHub Actions o GitLab CI, npm scarica ogni dipendenza dal registro npm. Questo può richiedere tempo perché npm crea cartelle profondamente annidate per le dipendenze, aumentando le operazioni di I/O.

• npm (🟡 Media) → Installa tutti i pacchetti in sequenza e li scrive integralmente in node_modules, creando duplicati per le sottodipendenze condivise.
• Yarn (🟢 Rapida) → Installa in parallelo e usa un sistema di caching migliore delle vecchie versioni di npm.
• pnpm (🟢 Rapida) → Usa un sistema di storage indirizzabile per contenuto e collega simbolicamente le dipendenze, evitando download ridondanti dopo la prima esecuzione.

Esempio: Installazione da zero di un progetto React + TypeScript (circa 1.000 dipendenze):

• npm: circa 65 secondi
• Yarn: circa 45 secondi
• pnpm: circa 40 secondi

Nota: i tempi sopra riportati sono benchmark illustrativi misurati su una macchina di sviluppo di fascia media in condizioni di rete normali. I risultati effettivi possono variare in base alle prestazioni dell’hardware, alla velocità della rete e alla complessità del progetto. L’obiettivo è evidenziare le differenze relative tra npm, Yarn e pnpm.

Ecco perché npm è valutato Medio, mentre Yarn e pnpm sono Rapidi nelle installazioni a freddo.

Velocità di installazione (con cache)

Un’installazione con cache avviene quando reinstalli dipendenze già scaricate una volta, ad esempio quando esegui:

npm install

dopo aver eliminato node_modules ma mantenendo la cache.

• npm (🟢 Rapida) → Memorizza localmente gli archivi tarball nella cache, quindi la reinstallazione salta il download.
• Yarn (🟢 Rapida) → Ottimo caching, riutilizza i pacchetti precedenti quasi istantaneamente.
• pnpm (🟢🟢 Molto rapida) → Il più veloce, perché non duplica affatto i pacchetti, ma li collega direttamente da un archivio globale.

Esempio: Dopo l’installazione iniziale sopra descritta, un’installazione con cache richiede:

• npm: circa 15 secondi
• Yarn: circa 12 secondi
• pnpm: circa 8 secondi

Nota: i tempi sopra riportati sono benchmark illustrativi misurati su una macchina di sviluppo di fascia media in condizioni di rete normali. I risultati effettivi possono variare in base alle prestazioni dell’hardware, alla velocità della rete e alla complessità del progetto. L’obiettivo è evidenziare le differenze relative tra npm, Yarn e pnpm.

L’architettura con archivio condiviso di pnpm gli offre qui un chiaro vantaggio.

Uso del disco

Si riferisce allo spazio totale usato dalla cartella node_modules e da qualsiasi cache dei pacchetti correlata.

• npm (🔴 Elevato) → Duplica molte sottodipendenze, con un uso del disco che spesso raggiunge i gigabyte nei grandi progetti.
• Yarn (🟡 Medio) → Leggermente più efficiente, ma archivia comunque molte copie dei pacchetti.
• pnpm (🟢 Basso) → Usa collegamenti simbolici verso uno storage centrale indirizzabile per contenuto. La stessa dipendenza condivisa da più progetti viene archiviata una sola volta.

Esempio: Lo stesso progetto React + TypeScript potrebbe usare:

• npm: circa 1,2 GB
• Yarn: circa 800 MB
• pnpm: circa 400 MB

Nota: le dimensioni sopra riportate sono benchmark illustrativi misurati su una macchina di sviluppo di fascia media in condizioni di rete normali. I risultati effettivi possono variare in base alle prestazioni dell’hardware, alla velocità della rete e alla complessità del progetto. L’obiettivo è evidenziare le differenze relative tra npm, Yarn e pnpm.

Questo è uno dei motivi principali per cui pnpm viene preferito per grandi monorepo o ambienti CI/CD.

Supporto monorepo

Un monorepo è un unico repository che contiene più progetti correlati, ad esempio un frontend, un backend e una libreria condivisa gestiti insieme. I workspace sono una funzionalità del gestore di pacchetti che permette di condividere le dipendenze in modo intelligente tra questi sottoprogetti.

• npm (🟡 Di base) → Ha introdotto i workspace npm relativamente di recente, ma manca di strumenti avanzati e ottimizzazioni delle prestazioni.
• Yarn (🟢 Solido) → Ha introdotto presto Yarn Workspaces, ampiamente adottati nelle grandi organizzazioni.
• pnpm (🟢🟢 Eccellente) → Progettato fin dall’inizio per i monorepo. Offre collegamenti automatici, cache condivise e tempi di installazione rapidi tra molti sottoprogetti.

Esempio: In un monorepo con:

• frontend/ (Next.js)
• backend/ (NestJS)
• shared/ (interfaccia + tipi TypeScript)

Potresti osservare che:

• npm installa tutto separatamente per ogni progetto.
• Yarn collega automaticamente le dipendenze condivise.
• pnpm fa lo stesso istantaneamente, con uno spazio su disco minimo e il miglior caching.

Ecco perché pnpm ottiene “Eccellente”, gestisce centinaia di pacchetti dei workspace con velocità ed efficienza.

Community ed ecosistema

La community e l’ecosistema riflettono quanto uno strumento sia maturo, supportato e ben integrato nei framework e nei sistemi CI/CD.

Poiché npm è stato rilasciato per primo e incluso in Node.js, nel tempo ha naturalmente costruito l’ecosistema più ampio. Yarn si è affermato per velocità e affidabilità, mentre pnpm è la scelta più recente e ad alte prestazioni che sta guadagnando rapidamente popolarità nei progetti su larga scala.

Quando scegliere ciascuno

Conclusione

Il Node Package Manager (npm) è il cuore della gestione delle dipendenze JavaScript, essenziale per lo sviluppo sia frontend sia backend. Alternative come Yarn e pnpm offrono maggiore velocità o ottimizzazione dello storage, ma npm rimane il riferimento universale per compatibilità e supporto dell’ecosistema.

Se la tua priorità è semplicità e affidabilità, rimani con npm. Se vuoi prestazioni massime e uso minimo del disco, prova pnpm.