Guide all'installazione

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.

Aurora YazılımRedazione 6 min di lettura
WSL Installation: Linux on Windows
Come si installa WSL?

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.

  1. Riavvii il computer al termine dell'installazione.
  2. All'avvio la finestra di Ubuntu compare da sola e decomprime i file; può richiedere alcuni minuti.
  3. Imposti un nome utente e una password Linux. Questo account è indipendente dal suo account Windows; la password viene richiesta per i comandi sudo.
  4. Aggiorni l'elenco dei pacchetti e il sistema.
powershellAdministrator PowerShell
wsl --install

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

bashUbuntu terminal
sudo apt update && sudo apt upgrade -y
powershellPowerShell
wsl -l -v wsl --status

Scegliere 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.
powershellComandi WSL di uso frequente
wsl --list --online wsl --install -d Debian wsl --set-default Ubuntu wsl --set-default-version 2 wsl --set-version Ubuntu 2 wsl --update wsl --shutdown

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

bash
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 input

Docker

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.

ini.wslconfig
[wsl2] memory=4GB processors=2

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

ErrorePerchéSoluzione
0x80370102La virtualizzazione è disattivataAbiliti VT-x o SVM nel BIOS/UEFI
0x8007019eLa funzionalità WSL non è abilitataEsegua di nuovo il comando in un PowerShell come amministratore oppure abiliti manualmente la funzionalità
wsl --install mostra solo il testo di aiutoWSL è già installatoUsi wsl --list --online e wsl --install -d Ubuntu
Nessuna connessione a internet, apt non funzionaConflitto con VPN o DNSDisattivi la VPN e riprovi; dopo wsl --shutdown, riapra
Il progetto è molto lentoI file si trovano sotto /mnt/cSposti il progetto nella home directory di Linux
powershellAbilitare manualmente i componenti
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

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