Guide all'installazione

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.

Aurora YazılımRedazione 6 min di lettura
Installing Node.js: Windows, macOS and Linux
Come si installa Node.js?

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.

MetodoA chi è rivoltoVantaggiSvantaggi
Installer ufficiale (.msi / .pkg)Principianti, progetto singoloIl modo più semplice, pochi clicCambiare versione è scomodo
nvm / nvm-windowsPiù progetti, lavoro di squadraPassi da una versione all'altra con un solo comandoLa configurazione iniziale è un po' più tecnica
Gestore di pacchetti (brew, apt, winget)Utenti che amano il terminaleInstallazione e aggiornamento da comandoLa 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:

powershellInstallazione LTS con winget
winget install OpenJS.NodeJS.LTS

Con 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:

powershellInstallazione e uso di nvm-windows
winget install CoreyButler.NVMforWindows # Close and reopen the terminal nvm install lts nvm use lts nvm list

Installare 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.

bashInstallazione 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 nvm
bashInstalla la versione LTS e impostala come predefinita
nvm 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.

bash
brew install node

Repository 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.
bashVerifica
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).

bashGestione delle versioni con nvm
# 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 use

Errori 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:

powershell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Errore 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.