Installare Node.js: Windows, macOS e Linux
Una guida passo dopo passo per installare Node.js con l'installer ufficiale o con nvm, cambiare versione e verificare l'installazione su tre sistemi operativi.

Per l'installazione di Node.js basta scaricare la versione LTS da nodejs.org ed eseguire l'installer. Se userai versioni diverse in più progetti, installa con nvm su macOS e Linux oppure con nvm-windows su Windows. Poi controlla la versione nel terminale con i comandi node -v e npm -v; se entrambi restituiscono un numero di versione, l'installazione è completata.
Che cos'è Node.js e perché installarlo
Node.js è un ambiente di esecuzione che esegue JavaScript fuori dal browser, direttamente sul vostro computer o su un server. Quasi tutti i moderni progetti web hanno bisogno di Node.js durante lo sviluppo: installare pacchetti, fare la build e avviare un server di sviluppo locale si fa con Node.js.
Anche se non usi strumenti come React, Vite, Next.js o Tailwind, il primo passaggio che incontri quando volete eseguire un progetto sul vostro computer è di solito npm install. Questo comando appartiene a npm, il gestore di pacchetti incluso in Node.js; in altre parole, senza installare Node.js non potete superare questo passaggio.
In questa guida vediamo due modi: l'installer ufficiale per chi lavora con una sola versione e un gestore di versioni per chi gestisce più progetti. La tabella qui sotto rende chiara la scelta.
| Metodo | A chi è rivolto | Vantaggi | Svantaggi |
|---|---|---|---|
| Installer ufficiale (.msi / .pkg) | Principianti, progetto singolo | Il modo più semplice, pochi clic | Cambiare versione è scomodo |
| nvm / nvm-windows | Più progetti, lavoro di squadra | Passi da una versione all'altra con un solo comando | La configurazione iniziale è un po' più tecnica |
| Gestore di pacchetti (brew, apt, winget) | Utenti che amano il terminale | Installazione e aggiornamento da comando | La versione nel repository può essere obsoleta |
Cosa serve prima di installare
Node.js è un'installazione leggera, ma qualche preparazione evita problemi in seguito. In particolare, se in passato sul vostro computer era installato un Node.js più vecchio, installare nvm senza rimuoverlo può causare un conflitto di PATH.
Fai attenzione anche all'architettura del processore. Sui Mac Apple Silicon (serie M) e sui dispositivi Windows basati su ARM l'installer di solito sceglie da solo l'architettura giusta; se scarichi manualmente, non confondere i file x64 e ARM64. L'architettura sbagliata può funzionare ma lentamente, oppure la build di alcuni pacchetti nativi può fallire.
Sui computer aziendali, un proxy o un firewall può impedire a npm di scaricare i pacchetti. Se vi trovi in una rete di questo tipo, prima di installare chiedi al vostro reparto IT l'accesso all'indirizzo del registro npm (registry.npmjs.org).
- Diritti di amministratore: necessari per l'installer ufficiale su Windows e macOS; nvm si installa nella cartella utente, quindi di solito non servono.
- Terminale: bastano PowerShell o Windows Terminal su Windows, Terminale su macOS e la shell predefinita su Linux.
- Rimozione della vecchia installazione: se passerai a un gestore di versioni, rimuovi prima il Node.js esistente da Impostazioni > App o dal vostro gestore di pacchetti.
- Scelta della versione: per la produzione e per imparare, scegli la versione LTS (supporto a lungo termine); la release Current è per chi vuole vedere in anticipo le novità.
Installare Node.js su Windows
Su Windows ci sono tre modi: l'installer ufficiale .msi, il gestore di pacchetti di Windows winget e nvm-windows per la gestione delle versioni. Qualunque tu scelga, dopo l'installazione chiudi e riapri i terminali aperti; altrimenti la nuova impostazione PATH non sarà visibile.
Con l'installer ufficiale
Scarica da nodejs.org il file .msi LTS per Windows, esegui l'installer e procedi con le opzioni predefinite. L'installer configura npm insieme a Node.js e lo aggiunge automaticamente al PATH.
Con winget
Con winget, incluso in Windows 10 e 11, potete installare la versione LTS con un solo comando:
winget install OpenJS.NodeJS.LTSCon nvm-windows
Se vi servono più versioni, installa nvm-windows; è un progetto separato da nvm per macOS/Linux, ma i comandi sono simili. Dopo l'installazione, apri PowerShell come amministratore ed esegui i comandi seguenti:
winget install CoreyButler.NVMforWindows # Close and reopen the terminal nvm install lts nvm use lts nvm listInstallare con nvm su macOS e Linux
Su macOS e Linux, il metodo più sano è usare nvm (Node Version Manager). nvm installa Node.js nella vostra cartella utente, quindi non serve sudo per installare i pacchetti globali ed eviti gli errori di permessi.
Il comando qui sotto scarica ed esegue lo script di installazione di nvm. Il README ufficiale suggerisce un indirizzo con il tag di versione; l'approccio più sicuro è copiare il comando più aggiornato dalla pagina GitHub di nvm.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash # Reload the shell (pick one depending on the shell you use) source ~/.bashrc source ~/.zshrc # Check that nvm is installed command -v nvmnvm install --lts nvm use --lts nvm alias default 'lts/*'Installazione su macOS con Homebrew
Se usi Homebrew, funziona anche il comando brew install node. Tuttavia questo comando di solito installa la versione più recente; se volete restare sulla LTS, nvm è più flessibile.
brew install nodeRepository delle distribuzioni Linux
Su Ubuntu o Debian il comando sudo apt install nodejs npm funziona, ma la versione nel repository è spesso più vecchia di quella richiesta dai progetti attuali. Per questo sulle macchine di sviluppo consigliamo nvm.
Come verifico l'installazione?
Al termine dell'installazione, apri un nuovo terminale ed esegui i comandi qui sotto. Entrambi dovrebbero restituire un numero di versione. Poi verifica con un piccolo script di prova che Node.js esegua il codice.
- L'output di node -v è un numero di versione che inizia con v.
- npm -v restituisce solo cifre; npm è incluso in Node.js.
- Se il comando di prova stampa il messaggio, il vostro ambiente è pronto; il passo successivo è la gestione dei pacchetti con i comandi npm.
node -v npm -v node -e "console.log('Node.js is working')"Come cambiare versione di Node
Progetti diversi possono richiedere versioni diverse di Node.js: un vecchio progetto gira su una versione vecchia, uno nuovo sull'ultima LTS. Con nvm cambiare versione di Node richiede pochi secondi.
Se inserisci un file .nvmrc nella cartella radice del progetto, tutti nel team usano la stessa versione. Basta entrare nella cartella e digitare nvm use per passare alla versione indicata nel file (nvm-windows non legge .nvmrc; lì la versione va digitata a mano).
# Installed versions nvm ls # LTS versions on the remote server nvm ls-remote --lts # Install and switch to a specific major version (example) nvm install 20 nvm use 20 # Save the version used in the project node -v > .nvmrc nvm useErrori comuni e soluzioni
La maggior parte dei problemi di installazione di Node.js riguarda PATH e permessi. L'elenco qui sotto riassume gli errori che vediamo più spesso e le soluzioni rapide.
Comando node non riconosciuto
Su Windows, l'errore “node is not recognized” compare di solito perché il terminale è stato aperto prima dell'installazione. Chiudi e riapri tutti i terminali e VS Code; se il problema persiste, controlla se la cartella di Node.js è nella variabile PATH.
Blocco degli script di PowerShell
PowerShell può rifiutarsi di eseguire il file npm.ps1. Il problema si risolve allentando la politica di esecuzione solo per il vostro utente:
Set-ExecutionPolicy -Scope CurrentUser RemoteSignedErrore di permessi EACCES
Se ricevi un errore EACCES durante npm install -g su macOS o Linux, Node.js è stato installato in una cartella di sistema. Non eseguire npm con sudo; rimuovi l'installazione esistente e reinstalla con nvm.
nvm: command not found
Lo script di installazione aggiunge le righe di nvm al profilo della vostra shell, ma un terminale già aperto non ne è a conoscenza. Esegui source ~/.zshrc o source ~/.bashrc, oppure riapri il terminale.
Cosa fare dopo l'installazione
Quando Node.js è pronto, completa il resto del vostro ambiente di sviluppo: consulta le nostre guide sull'installazione di VS Code per l'editor e su come caricare un progetto su GitHub per salvare e condividere il vostro codice. Tutte le guide passo dopo passo sono nella categoria guide all'installazione.
Se sviluppi un progetto web per un'attività, gli strumenti basati su Node.js contribuiscono direttamente alla velocità delle pagine minificando immagini, CSS e JavaScript in fase di build. Approfondiamo questo tema nel nostro servizio di ottimizzazione di velocità e prestazioni.
Se non hai un vostro team, o il vostro progetto richiede un sistema completo come una piattaforma e-commerce, affidare installazione e sviluppo a un team di esperti fa risparmiare tempo. Nei progetti di sito web aziendale e di piattaforma e-commerce configuriamo l'intero ambiente e tu vi concentri solo sui contenuti.
Domande frequenti
01Devo installare LTS o Current?
Scegli LTS per imparare, per i progetti aziendali e per i server; riceve aggiornamenti di sicurezza per lungo tempo. La release Current è adatta a chi vuole provare in anticipo le novità e ha un periodo di supporto più breve.
02Devo installare npm separatamente?
No. L'installer ufficiale, nvm e nvm-windows installano npm insieme a Node.js. Se volete aggiornare npm, potete usare il comando npm install -g npm.
03Come rimuovo completamente Node.js dal mio computer?
Su Windows, disinstallalo da Impostazioni > App ed elimina le cartelle npm e npm-cache nella vostra cartella utente. Se hai installato con nvm, potete rimuovere le versioni una per una con il comando nvm uninstall.
04Devo usare nvm anche su un server?
Sui server di sviluppo con un solo utente, nvm è pratico. Sui server di produzione sono più facili da gestire metodi ripetibili, come il repository ufficiale della distribuzione o quello di pacchetti consigliato da Node.js, oppure un'immagine Docker.
Installare Node.js correttamente mantiene fluidi tutti i passaggi di sviluppo successivi: bastano la versione LTS, la gestione flessibile delle versioni con nvm e un comando di verifica. Se invece di costruire il progetto da zero cerchi un software su misura o una soluzione di web design per la vostra attività, scopri le soluzioni software su misura di Aurora Yazılım o contattaci.


