Installazione di WSL: Linux su Windows
Come installare WSL 2 e Ubuntu su Windows per avere un vero ambiente di sviluppo Linux, collegarlo a VS Code e Docker e risolvere gli errori più comuni.

Per installare WSL, apra PowerShell come amministratore ed esegua il comando wsl --install. Abilita le funzionalità di Windows necessarie e scarica il kernel WSL 2 e, per impostazione predefinita, la distribuzione Ubuntu. Dopo il riavvio del computer si apre Ubuntu e si imposta un nome utente e una password Linux; l'installazione si verifica con wsl -l -v.
Che cos'è WSL e a cosa serve
WSL (Windows Subsystem for Linux), ovvero il sottosistema Linux di Windows, è una funzionalità di Microsoft che consente di eseguire un vero ambiente Linux dentro Windows. Senza configurare una macchina virtuale né un dual boot, si apre un terminale Ubuntu, si installano pacchetti con apt e si eseguono script bash.
Nello sviluppo web, la grande maggioranza dei server gira su Linux. Avere un ambiente di sviluppo simile al server di produzione evita errori di percorso dei file, di permessi e di maiuscole/minuscole che altrimenti emergerebbero solo online. Node.js, Python, PHP, Ruby e la maggior parte degli strumenti per database si installano con più facilità su Linux.
WSL 1 e WSL 2 a confronto
WSL 2 esegue un vero kernel Linux all'interno di una macchina virtuale leggera. Così funzionano strumenti che richiedono funzioni del kernel, come Docker, e le operazioni nel file system Linux sono molto veloci. WSL 1 traduce le chiamate Linux in chiamate Windows; a volte è più veloce nell'accesso ai file di Windows ma ha una compatibilità inferiore. WSL 2 è la versione predefinita nelle nuove installazioni ed è la scelta giusta per la maggior parte degli utenti.
Prerequisiti
WSL è una funzionalità solo per Windows; gli utenti di macOS e Linux non ne hanno bisogno perché hanno già un terminale di tipo Unix. Lato Windows valgono alcuni requisiti.
- Windows 11 o Windows 10 versione 2004 (build 19041) o successiva; può vedere la sua versione con il comando winver.
- La virtualizzazione (Intel VT-x o AMD-V/SVM) deve essere abilitata nelle impostazioni BIOS/UEFI. Nella scheda Prestazioni di Gestione attività, controlli sotto CPU la voce Virtualizzazione: Abilitata.
- Un account utente con diritti di amministratore.
- Alcuni GB di spazio libero su disco per la distribuzione e gli strumenti.
Installare WSL 2 con un solo comando
Faccia clic con il pulsante destro su PowerShell nel menu Start e scelga Esegui come amministratore. Il comando qui sotto abilita le funzionalità WSL e Piattaforma macchina virtuale, scarica il kernel Linux e installa Ubuntu.
- Riavvii il computer al termine dell'installazione.
- All'avvio la finestra di Ubuntu compare da sola e decomprime i file; può richiedere alcuni minuti.
- Imposti un nome utente e una password Linux. Questo account è indipendente dal suo account Windows; la password viene richiesta per i comandi sudo.
- Aggiorni l'elenco dei pacchetti e il sistema.
wsl --installPrimo aggiornamento e verifica
Aggiorni i pacchetti nel terminale Ubuntu, poi elenchi in PowerShell le distribuzioni installate e le relative versioni. Se nella colonna VERSION vede 2, WSL 2 funziona.
sudo apt update && sudo apt upgrade -ywsl -l -v wsl --statusScegliere e gestire una distribuzione
La distribuzione predefinita è Ubuntu, ma si possono installare anche Debian, openSUSE e altre. Usare Ubuntu su Windows è il modo più semplice per iniziare perché corrisponde esattamente alla maggior parte dei tutorial e della documentazione.
- wsl --list --online elenca le distribuzioni che può installare.
- wsl --set-version sposta da WSL 1 a WSL 2 una distribuzione installata.
- wsl --shutdown arresta tutte le distribuzioni e la macchina virtuale WSL; serve dopo le modifiche alla configurazione.
- Usi wsl --export per eseguire il backup di una distribuzione e wsl --import per ripristinarla.
wsl --list --online wsl --install -d Debian wsl --set-default Ubuntu wsl --set-default-version 2 wsl --set-version Ubuntu 2 wsl --update wsl --shutdownDove conviene tenere i file
In WSL convivono due file system. Le unità di Windows compaiono in Linux con percorsi come /mnt/c, mentre i file Linux si aprono in Esplora file di Windows in \\wsl.localhost\Ubuntu. Per un accesso facile in Esplora file, può digitare explorer.exe . nel terminale Ubuntu.
La regola d'oro è questa: tenga i file del progetto nel file system Linux (per esempio /home/kullanici/projeler). npm install, git status o i comandi di build eseguiti sotto /mnt/c rallentano sensibilmente a causa della traduzione tra i due sistemi, e il controllo dei file (hot reload) a volte non funziona affatto. La velocità dell'ambiente di sviluppo incide sulla produttività del team quanto gli interventi lato produzione come l'ottimizzazione di velocità e prestazioni.
Collegare VS Code, Git e Docker
Ciò che rende WSL davvero potente è che lavora insieme agli strumenti di Windows. L'editor di codice si apre in Windows, ma i comandi, le estensioni e il terminale girano dentro Linux.
VS Code
Installi in VS Code l'estensione WSL di Microsoft. Quando entra nella cartella del progetto nel terminale Ubuntu e digita code . , l'editor si apre in modalità WSL e in basso a sinistra compare un indicatore di connessione.
Git
Configuri Git separatamente dentro Linux; le impostazioni di Git su Windows non passano a WSL. Per le impostazioni dettagliate, consulti la nostra guida all'installazione di Git.
sudo apt install git -y git config --global user.name 'Ad Soyad' git config --global user.email ad@ornek.com git config --global core.autocrlf inputDocker
Docker Desktop usa nelle impostazioni il motore basato su WSL 2 e si integra con le distribuzioni che sceglie; in questo modo esegue i comandi docker dal terminale Ubuntu. I passaggi sono nell'articolo sull'installazione di Docker. Se preferisce installare il database direttamente su Ubuntu invece che in un container, i passaggi Linux della guida all'installazione di PostgreSQL funzionano in WSL esattamente come descritti.
Un tipico flusso di sviluppo in WSL
Dopo la configurazione, il lavoro quotidiano si assesta in una routine di pochi passaggi. Apre il terminale Ubuntu, entra nella cartella del progetto nella home e avvia l'editor con code . . Installa Node.js con nvm, Python con venv e il database con apt o Docker; tutto gira con gli stessi comandi dell'ambiente Linux del server online.
Questa impostazione fa la differenza soprattutto nei progetti in cui più sistemi dialogano tra loro. Per esempio, testare in locale su Linux il codice di integrazione che comunica con i servizi di magazzino, spedizione e contabilità di un negozio riduce le sorprese dopo il lancio. Anche le soluzioni software di settore come la gestione delle prenotazioni o degli annunci girano per lo più su server Linux, quindi vengono sviluppate e provate nello stesso ambiente.
Quando lavorate in team, far usare a tutti la stessa distribuzione e le stesse versioni degli strumenti evita i problemi del tipo da me funziona. Scrivere i passaggi di configurazione in un file README o in uno script di setup permette a chi arriva di preparare il proprio ambiente in pochi minuti.
Impostazioni di memoria e risorse
WSL 2 usa la memoria secondo necessità e durante le sessioni lunghe può rallentare Windows. Per impostare dei limiti, crei un file .wslconfig nella cartella utente di Windows (C:\Users\kullanici). Dopo la modifica, riavvii WSL con wsl --shutdown.
[wsl2] memory=4GB processors=2Errori comuni e soluzioni
La maggior parte degli errori di installazione di WSL deriva dalla virtualizzazione disattivata o da componenti di Windows mancanti. Annoti il codice di errore e lo confronti con la tabella qui sotto.
| Errore | Perché | Soluzione |
|---|---|---|
| 0x80370102 | La virtualizzazione è disattivata | Abiliti VT-x o SVM nel BIOS/UEFI |
| 0x8007019e | La funzionalità WSL non è abilitata | Esegua di nuovo il comando in un PowerShell come amministratore oppure abiliti manualmente la funzionalità |
| wsl --install mostra solo il testo di aiuto | WSL è già installato | Usi wsl --list --online e wsl --install -d Ubuntu |
| Nessuna connessione a internet, apt non funziona | Conflitto con VPN o DNS | Disattivi la VPN e riprovi; dopo wsl --shutdown, riapra |
| Il progetto è molto lento | I file si trovano sotto /mnt/c | Sposti il progetto nella home directory di Linux |
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestartDomande frequenti
01L'installazione di WSL rallenta Windows?
WSL consuma risorse solo mentre lo usa; quando è spento, il suo impatto è trascurabile. L'uso di memoria può crescere durante le sessioni lunghe e si può limitare con .wslconfig. Anche il comando wsl --shutdown libera subito le risorse.
02Posso eseguire in WSL app Linux con interfaccia grafica?
Su Windows 11 e sulle versioni attuali di Windows 10, le app Linux con interfaccia grafica possono aprirsi direttamente sul desktop di Windows tramite WSLg. La maggior parte del lavoro di sviluppo non ne ha bisogno; bastano il terminale e VS Code.
03WSL può sostituire un server?
No. WSL è un ambiente di sviluppo; si ferma quando il computer si spegne e non è pensato per l'accesso dall'esterno. Per un sito o un'applicazione online occorre usare un vero server o un ambiente cloud.
04Posso rimuovere completamente WSL?
Sì. Prima elimini le distribuzioni con wsl --unregister; questo elimina in modo permanente tutti i file al loro interno. Poi può disattivare WSL e Piattaforma macchina virtuale nelle funzionalità di Windows.
L'installazione di WSL offre a chi sviluppa su Windows un ambiente di lavoro che parla la stessa lingua del server di produzione. Se cerca soluzioni software di settore create per la sua attività e che girano in modo affidabile su server Linux, scopra i nostri prodotti; per un progetto personalizzato di web design o di integrazione, ci raggiunga tramite la nostra pagina contatti.


