Report su installazione e configurazione git e repository

Contesto

Git è il sistema di controllo versione distribuito più diffuso al mondo. Permette di tracciare le modifiche al codice sorgente nel tempo, collaborare con altri sviluppatori e gestire versioni parallele di un progetto tramite branch.

WSL (Windows Subsystem for Linux) consente di eseguire un ambiente Linux completo direttamente su Windows, senza macchina virtuale. È lo strumento ideale per chi sviluppa su Windows ma vuole un toolchain Linux nativo, incluso Git.

Questo articolo descrive l’intero processo: dall’installazione di Git in WSL, alla configurazione dell’identità utente, fino alla creazione e gestione del primo repository.

Analisi

Installazione di Git

In un terminale WSL (Ubuntu), aggiornare l’indice dei pacchetti e installare Git:

sudo apt update
sudo apt install git -y
git --version
# Output atteso: git version 2.43.x

Configurazione dell’identità globale

Git associa nome e indirizzo email ad ogni commit. Vanno impostati una volta sola con il flag —global:

git config --global user.name "Nome Cognome"
git config --global user.email "tua@email.com"
git config --global core.editor nano   # editor preferito (nano, vim, code)
git config --global init.defaultBranch main  # branch principale chiamato main

Verifica la configurazione attiva:

git config --list

Creazione del primo repository locale

Creare una cartella di progetto e inizializzare Git al suo interno:

mkdir ~/mio-progetto
cd ~/mio-progetto
git init

Output atteso:

Initialized empty Git repository in /home/user/mio-progetto/.git/

La cartella nascosta .git/ contiene tutta la storia del repository.

Primo commit

Creare un file, aggiungerlo all’area di staging e registrare il primo commit:

echo "# Mio Progetto" > README.md
git add README.md
git status           # mostra il file pronto per il commit
git commit -m "feat: primo commit — aggiunto README"
git log --oneline    # verifica che il commit sia stato registrato

Collegare un repository remoto (GitHub/GitLab)

Per sincronizzare il repository locale con uno remoto:

git remote add origin https://github.com/utente/mio-progetto.git
git push -u origin main

Il flag -u imposta origin/main come upstream predefinito, quindi i push successivi si eseguono semplicemente con git push.

Flusso di lavoro quotidiano

ComandoScopo
git statusStato dei file (modificati, staged, ecc.)
git add <file>Aggiunge file all’area di staging
git add .Aggiunge tutte le modifiche
git commit -m "..."Registra uno snapshot del progetto
git pushInvia i commit al repository remoto
git pullScarica e integra le modifiche remote
git log --onelineCronologia compatta dei commit
git branchElenca i branch esistenti
git checkout -b feature/nomeCrea e passa a un nuovo branch

Note specifiche per WSL

  • I file del filesystem Windows si trovano sotto /mnt/c/. Git funziona anche lì, ma le prestazioni sono nettamente migliori lavorando nel filesystem Linux (~/).
  • Per aprire VSCode dal terminale WSL direttamente nella cartella del progetto: code .
  • Le credenziali GitHub si possono gestire tramite il credential helper di Git o con chiavi SSH generate in WSL.

Considerazioni finali

Git in WSL offre un’esperienza di sviluppo completa e performante su Windows. L’integrazione con VSCode (tramite l’estensione Remote - WSL) e con GitHub rende il flusso di lavoro fluido e professionale. Una volta padroneggiati i comandi base (init, add, commit, push, pull), è naturale evolvere verso branch multipli, pull request e strategie di merge più avanzate.

Il passo successivo consigliato è esplorare GitHub Actions per automatizzare test e deploy direttamente dal repository remoto.

Riferimenti

WSL Setup GitHub Workflow Versioning e Controllo del Codice