Installare Angular su Windows 11 o 10 da prompt dei comandi

Installare Angular su Windows 11 o Windows 10 da prompt dei comandi non è complicato, ma conviene farlo con una sequenza pulita: prima il runtime JavaScript, poi il gestore pacchetti, infine Angular CLI. Se salti i controlli iniziali, il classico risultato è un npm che non trova i permessi, un PATH incompleto o una versione di Node troppo vecchia per il progetto che vuoi creare.

Qui l’obiettivo è semplice: arrivare a un ambiente stabile da terminale, verificabile e replicabile. Non serve aprire il browser per installare nulla, salvo i casi in cui preferisci il download manuale di Node.js. Il resto si fa da cmd o da PowerShell, con qualche verifica che ti evita ore di troubleshooting inutile più avanti.

Prerequisiti che contano davvero

Angular gira sopra Node.js e npm. In pratica, prima di pensare a ng, devi avere una versione di Node compatibile con la release Angular che vuoi usare. Per progetti nuovi, la regola pratica è usare una versione LTS recente di Node, non una build vecchia recuperata da installazioni precedenti.

Su Windows 11 e Windows 10 il punto critico non è tanto l’installazione in sé, quanto il PATH e la presenza di eventuali installazioni multiple. Se hai già Node installato da tempo, verifica subito quale versione il sistema vede davvero da prompt.

Comandi base di verifica:

node -v
npm -v
where node
where npm

Se node -v e npm -v restituiscono versioni, sei già a buon punto. Se where node mostra più percorsi, hai quasi certamente un conflitto di installazioni. In quel caso, prima di aggiungere altro software, conviene capire quale binario viene caricato per primo nel PATH.

Installare Node.js su Windows 11 o 10

La strada più lineare è installare la versione LTS di Node.js dal sito ufficiale. Durante il setup, lascia attiva l’opzione che aggiunge Node al PATH. È un dettaglio banale, ma è quello che evita la metà dei problemi successivi con npm e ng.

Se preferisci il prompt, puoi usare un package manager come winget, quando disponibile. È comodo su macchine recenti o su ambienti aziendali dove vuoi ridurre i passaggi manuali.

winget install OpenJS.NodeJS.LTS

Dopo l’installazione, chiudi e riapri il terminale. Windows non aggiorna sempre il PATH della sessione corrente, quindi un node non trovato può essere solo un problema di shell già aperta.

Verifica minima:

node -v
npm -v

Se il comando risponde con una versione, il runtime è pronto. Se invece ricevi un errore tipo command not found o not recognized as an internal or external command, il problema è quasi sempre il PATH o un’installazione incompleta.

Verificare che npm sia usabile prima di Angular

Angular CLI si appoggia a npm. Per questo conviene controllare subito se il gestore pacchetti è funzionante e se riesce a parlare con il registry pubblico. Non serve fare test complessi: basta vedere se riesce a leggere la configurazione e a risolvere il pacchetto base.

npm config get registry
npm ping

Il valore atteso per il registry è in genere https://registry.npmjs.org/. Se npm ping fallisce, il problema può essere rete, proxy aziendale, DNS o un certificato intercettato da appliance di sicurezza. In quel caso Angular non c’entra ancora nulla: il collo di bottiglia è prima.

Se lavori dietro proxy, imposta esplicitamente le variabili o la configurazione npm. Esempio:

npm config set proxy http://proxy.example.local:8080
npm config set https-proxy http://proxy.example.local:8080

Nota operativa: non hardcodare credenziali in chiaro nei file di configurazione condivisi. Se il proxy richiede autenticazione, usa il meccanismo previsto dall’azienda o un secret manager; se hai già inserito dati sensibili in file locali, ruotali o rimuovili subito.

Installare Angular CLI da prompt

Angular CLI è lo strumento che crea, serve e costruisce i progetti Angular. L’installazione globale è la via più semplice per iniziare su Windows, perché ti consente di usare il comando ng da qualunque cartella.

npm install -g @angular/cli

Dopo l’installazione, controlla subito la versione:

ng version

Se il comando non viene riconosciuto, di solito il pacchetto è stato installato ma la cartella dei binari globali di npm non è nel PATH. Su Windows, questa cartella è spesso sotto il profilo utente, ad esempio nella directory di roaming di npm. Il percorso esatto può variare, quindi è meglio leggerlo dal sistema invece di indovinarlo.

npm config get prefix
npm root -g

Se serve, controlla anche dove Windows cerca i comandi globali e aggiungi il percorso corretto alle variabili d’ambiente utente. Dopo la modifica, riapri il terminale e ripeti ng version.

Creare il primo progetto Angular

Quando CLI è disponibile, puoi creare il progetto direttamente da prompt. La procedura standard genera una struttura già pronta per sviluppo, build e test.

ng new mio-progetto

Durante la procedura, Angular ti chiede se vuoi attivare il routing e quale formato di fogli stile preferisci. Se stai impostando un progetto reale, il routing di solito conviene abilitarlo subito; scegliere CSS, SCSS o altro dipende dallo standard del team.

Se vuoi evitare le domande interattive, puoi forzare alcune opzioni direttamente da comando. Esempio:

ng new mio-progetto --routing --style=scss

Una volta creato il progetto, entra nella directory e avvia il server di sviluppo:

cd mio-progetto
ng serve -o

L’opzione -o apre automaticamente il browser. Se vuoi mantenere il controllo manuale, omettila e naviga tu su http://localhost:4200.

Capire cosa succede quando Angular parte

Il comando ng serve avvia un processo di sviluppo con hot reload e compilazione incrementale. Non è un server di produzione: serve per lavorare velocemente sul codice, non per esporre l’app a utenti finali.

Se tutto è corretto, il terminale mostra un output simile a questo:

✔ Browser application bundle generation complete.

Initial Chunk Files | Names         | Raw Size
main.js             | main          | ...

Local:            http://localhost:4200/

Se invece vedi errori di compilazione, il problema non è l’installazione ma il progetto. Qui entra in gioco la diagnostica classica: leggere il messaggio, individuare il file coinvolto e correggere il primo errore, non quello che compare in cascata.

Problemi comuni su Windows e come leggerli bene

Il primo problema tipico è il conflitto tra versioni di Node. Succede quando hai installazioni vecchie, magari fatte con installer diversi o con strumenti come nvm per Windows. Il sintomo è semplice: node -v mostra una versione, ma ng si comporta in modo incoerente o fallisce durante l’installazione di dipendenze native.

Per falsificare l’ipotesi in pochi minuti, confronta il percorso reale del binario e la versione caricata:

where node
where npm
node -p "process.execPath"

Se i percorsi non sono coerenti, sistemare il PATH è spesso più efficace che reinstallare tutto. In ambienti dove serve cambiare spesso versione, nvm for Windows è una soluzione sensata, ma va usata con disciplina: una sola versione attiva per terminale, niente installazioni sparse a mano.

Il secondo problema tipico è il blocco su permessi o policy di esecuzione. Su PowerShell, ad esempio, puoi trovarti con script bloccati. In quel caso non forzare alla cieca: verifica la policy corrente e cambia solo ciò che serve nel profilo utente, se la policy aziendale lo consente.

Get-ExecutionPolicy -List

Se il blocco riguarda script firmati o esecuzione remota, l’azione corretta dipende dal contesto di sicurezza della macchina. In un endpoint gestito da IT, il rollback deve essere chiaro: riportare la policy allo stato precedente dopo la prova o lavorare con un terminale autorizzato.

Il terzo problema frequente è la rete: proxy, firewall, DNS o certificati intercettati. Se npm install -g @angular/cli resta fermo o restituisce errori TLS, controlla prima la connettività verso il registry e poi l’eventuale ispezione SSL dell’infrastruttura. In questi casi la soluzione non è “riprovare più tardi”, ma capire quale tratto della catena si rompe.

Installazione offline o in rete aziendale

In ambienti chiusi, l’installazione diretta dal registry pubblico può non essere possibile. La strategia corretta è preparare un repository interno o una cache proxy per i pacchetti npm, non copiare a mano file sparsi da una macchina all’altra.

Se hai un mirror interno, imposta il registry locale:

npm config set registry https://registry.interno.example.local/

Se invece devi lavorare temporaneamente offline, puoi scaricare i pacchetti su una macchina connessa e usare il flusso previsto dal tuo ambiente, ma qui il dettaglio operativo dipende dal sistema di distribuzione interno. Il punto da non perdere è uno: evitare installazioni manuali non tracciate, perché poi il debug diventa quasi impossibile.

Verifica finale dell’ambiente Angular

Quando hai completato installazione e configurazione, fai una verifica in tre livelli: runtime, CLI e progetto. È il modo più rapido per capire dove si rompe qualcosa.

1. Runtime: node -v e npm -v devono restituire versioni coerenti e recenti.

2. CLI: ng version deve mostrare Angular CLI senza errori di comando non trovato.

3. Progetto: ng new test-angular e poi ng serve devono completarsi senza errori di dipendenze o rete.

Se vuoi una prova ancora più concreta, crea un progetto di test, avvialo e controlla che il browser risponda su localhost:4200. La verifica corretta non è “il comando parte”, ma “il progetto viene compilato e servito davvero”.

Manutenzione pratica: aggiornamenti e pulizia

Una volta installato Angular, non lasciare l’ambiente fermo per mesi. Le dipendenze frontend cambiano in fretta, e una combinazione vecchia di Node, npm e Angular CLI può diventare un costo nascosto nel momento in cui devi aggiornare il progetto.

Controlla periodicamente le versioni installate e aggiorna con criterio, non per abitudine. Per CLI globale:

npm update -g @angular/cli

Se un progetto specifico richiede una versione diversa di Angular, non forzare la CLI globale a sostituire tutto. In quel caso conta il package.json del progetto e la versione dichiarata lì. Il terminale globale serve per orchestrare, non per ignorare i vincoli del repository.

Se qualcosa si rompe dopo un aggiornamento, la prima mossa reversibile è tornare alla versione precedente di Node o della CLI e ripetere la verifica. In un ambiente di sviluppo, il rollback è parte della procedura, non un’ammissione di fallimento.

Sequenza rapida consigliata da prompt

Se vuoi una traccia sintetica da usare subito su Windows 11 o 10, questa è la sequenza minima sensata:

node -v
npm -v
npm ping
npm install -g @angular/cli
g version
ng new mio-progetto
cd mio-progetto
ng serve -o

Se uno di questi passaggi fallisce, non andare avanti a tentativi. Fermati sul primo errore, leggi l’output, identifica il layer coinvolto e correggi lì. Con Angular su Windows, il tempo perso non è quasi mai nell’installazione iniziale: è nel non guardare abbastanza presto il punto esatto in cui la catena si è rotta.