Configurare l'Ambiente di Sviluppo su Windows 11 con WSL2, Astro e Node

> pub_date:

Se avete deciso di abbracciare la velocità dei siti statici e l’efficienza di strumenti come Astro, Tailwind e Vite, vi serve un ambiente di sviluppo coerente e facilmente replicabile.

Su Windows 11, l’approccio più robusto consiste nell’installare gli strumenti di sviluppo all’interno di Linux tramite WSL2, mantenendo Windows come ambiente desktop e Linux come piattaforma operativa.

Questa guida mostra come configurare da zero un notebook appena reinstallato, ottenendo un workflow pulito, isolato e facilmente manutenibile.

1. Installare WSL2 e Git

Aprite Windows Terminal o PowerShell come amministratore ed eseguite:

wsl --install

Questo comando:

  • abilita il Windows Subsystem for Linux (WSL2);
  • attiva la Virtual Machine Platform;

Al termine dell’installazione riavviate il computer.

Dopo aver riavviato installate l’ultima versione LTS di Ubuntu o della distribuzione che preferite.

Alla prima apertura di Ubuntu vi verrà richiesto di:

  1. scegliere un nome utente;
  2. impostare una password.

Terminata la configurazione iniziale, impostate subito l’identità Git globale:

git config --global user.name "Il Tuo Nome"
git config --global user.email "[email protected]"

Potete verificare la configurazione con:

git config --list

2. Installare VS Code e sincronizzare le impostazioni

Installate Visual Studio Code su Windows.

Se utilizzate già VS Code su altre macchine, conviene attivare la sincronizzazione delle impostazioni:

  1. cliccate sull’icona dell’account in basso a sinistra;
  2. selezionate Turn on Settings Sync;
  3. effettuate l’accesso con il vostro account GitHub o Microsoft.

In pochi minuti verranno ripristinati:

  • temi;
  • scorciatoie;
  • impostazioni;
  • estensioni.

Estensioni consigliate

Per uno stack basato su Astro, Tailwind, Node.js e Python risultano particolarmente utili:

WSL (Microsoft) | Integrazione completa tra VS Code e Ubuntu Astro | Supporto ai file .astro | Tailwind CSS IntelliSense | Autocompletamento e validazione classi Tailwind Vite (Anthony Fu) | Gestione del dev server Python (Microsoft) | IntelliSense, debug e tooling Python Prettier | Formattazione automatica ESLint | Analisi statica JavaScript/TypeScript

3. Installare Node.js tramite NVM

Una buona pratica consiste nell’installare Node.js all’interno di Ubuntu anziché in Windows.

Evitate:

sudo apt install nodejs

poiché spesso distribuisce versioni meno aggiornate.

Installate invece NVM (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash

Ricaricate la shell:

source ~/.bashrc

Installate quindi l’ultima versione LTS di Node.js:

nvm install --lts

Verificate l’installazione:

node -v
npm -v

4. Configurare Python

Ubuntu include già Python 3.

Installate gli strumenti essenziali:

sudo apt update
sudo apt install python3-pip python3-venv -y

Verificate le versioni:

python3 --version
pip3 --version

Per nuovi progetti Python potete creare ambienti virtuali dedicati:

python3 -m venv .venv
source .venv/bin/activate

5. Aprire progetti Linux in VS Code

Uno dei vantaggi principali di WSL2 è il comando:

code .

che apre la cartella corrente di Ubuntu direttamente nell’interfaccia di VS Code eseguita su Windows.

Creare un nuovo progetto Astro

Dal terminale Ubuntu:

mkdir -p ~/Progetti
cd ~/Progetti

Entrate nella directory del progetto:

cd nome-del-progetto
code .

Clonare un progetto esistente

Se il repository è già presente su GitHub:

cd ~/Progetti

git clone https://github.com/tuo-username/nome-progetto.git

cd nome-progetto
code .

6. Sviluppo quotidiano

Quando VS Code si apre correttamente tramite WSL, nell’angolo inferiore sinistro comparirà:

WSL: Ubuntu (o la ditro che avete scelto)

Da quel momento tutti i comandi verranno eseguiti all’interno di Linux.

Installare le dipendenze

Necessario dopo un clone da GitHub:

npm install

Avviare il server di sviluppo

npm run dev

Astro mostrerà un output simile:

Local: http://localhost:4321/

Aprite l’indirizzo indicato dal browser Windows e iniziate a sviluppare.

Conclusione

Con questa configurazione:

  • Windows rimane il sistema desktop;
  • Ubuntu gestisce Node.js, Python e Git;
  • VS Code opera come interfaccia grafica;
  • ogni progetto rimane isolato in un ambiente Linux reale;
  • aggiornamenti e migrazioni future risultano molto più semplici.

Per chi lavora con Astro, Vite, Tailwind e strumenti moderni dell’ecosistema JavaScript, WSL2 rappresenta oggi l’approccio più pulito e prevedibile su Windows 11.