martedì 7 ottobre 2025

Git: Gestione dei repository remoti

Per collaborare efficacemente in un progetto Git, è fondamentale comprendere come gestire i repository remoti. I repository remoti sono versioni dei progetti ospitati su un server (Internet, rete locale o persino la stessa macchina, purché in un percorso distinto).

La gestione dei remoti comprende operazioni quali:

  • Aggiungere o rimuovere repository remoti.
  • Consultare la loro configurazione.
  • Sincronizzare i dati tramite fetch, pull e push.
  • Ispezionare e mantenere aggiornate le referenze remote.


Visualizzare i repository remoti 

Per verificare quali repository remoti sono attualmente associati a un progetto Git, è possibile utilizzare il comando:

git remote

Tale comando restituisce l’elenco degli alias (shortname) configurati per i repository remoti. Qualora il repository sia stato clonato da un server remoto, sarà presente almeno l’alias origin, che costituisce la denominazione predefinita attribuita da Git al repository di origine del clone.

Git remote
FIG 1 - Git remote

Per ottenere, oltre ai nomi, anche gli indirizzi URL associati ai repository remoti (distinti per operazioni di fetch e push), è possibile utilizzare l’opzione -v:

git remote -v

git remote -v
FIG 2 - git remote -v

Un progetto con più collaboratori può avere vari remoti, ciascuno con il proprio URL e protocollo di accesso (HTTPS, SSH, Git).


Aggiungere un nuovo repository remoto

Per aggiungere un nuovo repository remoto e assegnargli un shortname (alias):

git remote add <shortname> <url>

Esempio:

git remote add pd24 https://github.com/Pedestrian24/Hello.git

Da questo momento, sarà possibile richiamare il repository remoto con pd24 invece di digitare l’intero URL.

git remote add
FIG 3 - git remote add

Sincronizzazione con Repository Remoti: Fetch e Pull

Nell’ambito della collaborazione su progetti Git, una delle operazioni fondamentali consiste nel mantenere il proprio repository locale aggiornato rispetto al repository remoto. A tal fine, Git mette a disposizione due comandi principali: git fetch e git pull.


1. git fetch: Recupero dei dati senza integrazione automatica

Scarica i nuovi dati dal remoto senza modificarne l’integrazione nel branch attuale. Il comando:

git fetch <remote>

provvede a contattare il repository remoto specificato (ad esempio origin) e a scaricare tutte le nuove informazioni (commit, branch, tag) che non sono ancora presenti localmente.

Dopo l’esecuzione di git fetch, il repository locale contiene riferimenti aggiornati a tutti i branch remoti (ad esempio origin/main, origin/dev, ecc.), senza tuttavia modificare il contenuto della working directory o del branch corrente.

Pertanto:

  • I dati vengono aggiornati nella copia locale del database Git.
  • Non viene modificato il codice attualmente in lavorazione.
  • L’integrazione delle modifiche (mediante merge o rebase) deve essere eseguita manualmente dall’utente.


Esempio pratico:

git fetch origin

Scarica dal server remoto origin tutte le modifiche effettuate da altri collaboratori dall’ultimo fetch, lasciando intatto lo stato della propria area di lavoro.

git fetch origin
FIG 4 - git fetch origin


2. git pull: Recupero e fusione automatica

Il comando:

git pull <remote> <branch>

rappresenta una scorciatoia che combina due operazioni:

  • git fetch
    recupera i dati aggiornati dal repository remoto.
  • git merge (o git rebase se configurato)
    integra automaticamente i dati recuperati nel branch locale attualmente attivo.

In caso di repository clonato con il comando git clone, Git configura automaticamente il branch locale predefinito (main o master, a seconda della nomenclatura del server) per tracciare il branch remoto corrispondente (origin/main o origin/master).

Pertanto, il semplice comando:

git pull

provvede a scaricare e integrare nel branch locale eventuali modifiche presenti sul server remoto di origine.

git pull
FIG 5 - git pull

A partire da Git 2.27, se la variabile di configurazione pull.rebase non è impostata, l’esecuzione di git pull genera un avviso, invitando l’utente a scegliere un comportamento predefinito

Configurazioni consigliate:

  • Comportamento standard (merge)
    git config --global pull.rebase "false"
       
    In questo caso, git pull tenta un fast-forward quando possibile, altrimenti effettua un merge commit.
  • Comportamento alternativo (rebase)
    git config --global pull.rebase "true"
       
    In questo scenario, le modifiche locali vengono riallineate sopra la cronologia del branch remoto, mantenendo una storia più lineare e priva di commit di merge superflui.


Pubblicazione delle Modifiche su Repository Remoti (Push)

Una volta raggiunto uno stato stabile del proprio progetto locale, è necessario condividere le modifiche con gli altri collaboratori pubblicandole su un repository remoto.

Questa operazione viene eseguita tramite il comando:

git push <remote> <branch>


Concetto di Push

Il comando git push invia i commit presenti nel branch locale specificato verso il corrispondente branch remoto.

Ad esempio, per pubblicare il contenuto del branch main(o master, a seconda della nomenclatura utilizzata) sul repository remoto di default origin, è sufficiente eseguire:

git push origin main

In questo modo, lo stato corrente del branch locale master viene replicato nel corrispondente branch remoto origin/main.


Requisiti e condizioni per il push

L’operazione di push ha successo solo se:

  • L’utente dispone di permessi di scrittura sul repository remoto.
  • La cronologia del branch remoto è compatibile con quella del branch locale.

Nel caso in cui un altro collaboratore abbia già eseguito un push al branch remoto dopo il vostro ultimo aggiornamento locale, Git rifiuterà l’operazione per evitare la perdita o la sovrascrittura dei commit altrui.


Sincronizzazione prima del push

Quando il push viene rifiutato a causa di divergenze, è necessario:

  1. Eseguire un fetch per recuperare i commit remoti:
    git fetch origin 
  2. Integrare tali modifiche nel branch locale, utilizzando:
    git merge origin/main
    fusione classica, mantiene entrambe le linee di sviluppo.
    git rebase origin/main
    riallineamento lineare, utile per cronologie pulite.
  3. Eseguire nuovamente il push:
    git push origin main

Solo dopo questa integrazione sarà possibile completare la pubblicazione delle modifiche.


Scenari avanzati

  1. Push di tutti i branch locali:
    git push --all origin
  2. Pubblicazione dei tag (per versionamento o release):
    git push origin --tags
  3. Forzare il push (operazione rischiosa): 
    git push --force origin master
    Questo comando sovrascrive la cronologia remota con quella locale, potenzialmente cancellando il lavoro di altri. Deve essere utilizzato solo in scenari controllati (es. riscrittura della cronologia prima della pubblicazione ufficiale).

git push origin main
FIG 6 - git push origin main


Ispezione di un Repository Remoto (show)

Per gestire in maniera efficace le interazioni con repository remoti, Git mette a disposizione il comando:

git remote show <nome-remoto>

Questo strumento consente di ottenere una panoramica dettagliata sulle configurazioni associate a un determinato remote, come ad esempio l’URL di fetch e push, i branch tracciati e le impostazioni di sincronizzazione.


Utilizzo di base

Ad esempio, per ispezionare il remote predefinito origin:

git remote show origin

git remote show origin
FIG 7 - git remote show origin

L’output restituisce informazioni essenziali, tra cui:

  • Fetch/Push URL. Gli indirizzi utilizzati per scaricare (fetch) o pubblicare (push) dati.
  • HEAD branch. Il branch predefinito del remote (spesso master o main).
  • Remote branches. I branch remoti tracciati dal repository locale.
  • Branch locali configurati per pull/push. Le associazioni automatiche di sincronizzazione.


Output avanzato in scenari complessi

In progetti di grandi dimensioni o con più branch remoti, l’output può essere molto più articolato.

git remote show origin
FIG 8 - git remote show origin

In questo caso, emergono ulteriori informazioni:

  • Branch nuovi (new)
    individuati sul server, ma non ancora scaricati localmente. Verranno sincronizzati al prossimo fetch.
  • Branch obsoleti (stale)
    presenti localmente ma rimossi dal server. Git suggerisce di eliminarli con:
    git remote prune origin
  • Associazioni multiple
    un branch locale può essere configurato per sincronizzarsi automaticamente con un branch remoto specifico.


Casi d’uso pratici

  • Verifica rapida della configurazione remota prima di eseguire git pull o git push.
  • Identificazione di branch obsoleti per mantenere un repository locale pulito.
  • Controllo dei permessi e degli URL (utile quando si lavora con remoti accessibili sia via HTTPS che SSH).
  • Diagnosi di problemi di sincronizzazione, ad esempio quando un branch non è correttamente tracciato.


Rinomina ed Eliminazione dei Repository Remoti (rename, remove)

La gestione dei repository remoti in Git non si limita alla loro configurazione iniziale: in determinati scenari può essere necessario rinominare un remote per una migliore leggibilità, oppure rimuoverlo se non più utilizzato. Git mette a disposizione comandi specifici per entrambe le operazioni.


1. Rinomina di un Remote

Per modificare il nome abbreviato (shortname) di un remote si utilizza:

git remote rename <vecchio-nome> <nuovo-nome>


Esempio

Se si desidera rinominare un remote chiamato pd24 in pippo:

git remote rename pd24 pippo
git remote
git remote rename
FIG 9 - git remote rename

L’operazione non si limita a rinominare il remote, ma aggiorna automaticamente anche tutti i riferimenti ai branch di tracking.

Ad esempio:

  • Prima: pd24/main
  • Dopo: pippo/main

Questo garantisce coerenza e riduce il rischio di errori manuali.


2. Rimozione di un Remote

Se un remote non è più necessario (ad esempio perché il server è stato spostato, un mirror è stato dismesso o un collaboratore non contribuisce più), è possibile eliminarlo con:

git remote remove <nome>

oppure, in alternativa:

git remote rm <nome>


Esempio

Per rimuovere il remote pippo:

git remote remove pippo
git remote
git remote remove
FIG 10 - git remote remove


Dopo l’eliminazione:

  • Tutti i remote-tracking branch associati a quel remote vengono rimossi.
  • Le configurazioni locali legate al remote (ad esempio impostazioni di fetch e push) vengono eliminate.



Tabella di Sintesi: Principali Operazioni sui Repository Remoti

ComandoDescrizioneEsempio
git remote -vElenca i remoti configurati con i rispettivi URLgit remote -v
git remote add <nome> <url>Aggiunge un nuovo remotogit remote add pd24
 https://github.com/Pedestrian24/Hello.git
git fetch <remote>Scarica i dati dal remoto senza integrarligit fetch origin
git pullScarica e integra i dati dal remotogit pull origin master
git push <remote> <branch>Invia i commit locali al remotogit push origin main
git remote show <remote>Mostra dettagli di configurazione di un remotogit remote show origin
git remote rename <old> <new>Rinomina un remotogit remote rename pd24 pippo
git remote remove <nome>Rimuove un remoto e le relative configurazionigit remote remove pippo


Best Practice

  • Usare nomi coerenti: origin per il repository principale, upstream per il fork originale.
  • Controllare sempre con git fetch prima di un git pull: riduce i conflitti e rende più prevedibile il flusso.
  • Evitare git push --force salvo nei branch personali: può riscrivere la cronologia e creare problemi ai collaboratori.
  • Pulire i branch remoti obsoleti con:
    git remote prune origin
  • Preferire SSH a HTTPS per ambienti professionali: maggiore sicurezza e praticità nell’autenticazione.





venerdì 3 ottobre 2025

MS Outlook: Aggiungere automaticamente i contatti da un'email quando si risponde

Nell’attività quotidiana di un professionista IT o di un knowledge worker, la gestione dei contatti è un aspetto cruciale. Ogni giorno vengono scambiate centinaia di email, spesso con interlocutori che non sono ancora presenti nella rubrica di Outlook. In questi casi, il rischio è quello di perdere tempo nel reinserire manualmente i dati o, peggio, non riuscire a recuperare in futuro un indirizzo di posta elettronica utile.

Microsoft Outlook, pur essendo una delle piattaforme di posta elettronica più diffuse in ambito aziendale, non offre di default una funzionalità che consenta di aggiungere automaticamente i contatti quando si risponde a un’email. Per sopperire a questa mancanza è possibile implementare una macro VBA (Visual Basic for Applications), che permette di automatizzare l’inserimento dei contatti direttamente all’interno di Outlook.

Attraverso una semplice macro VBA è possibile configurare Outlook in modo che, ogni volta che si risponde a un messaggio, il mittente e tutti i destinatari vengano automaticamente salvati nella cartella contatti predefinita.

Procedura operativa:

  • Aprire l’editor VBA: premere Alt+F11 per accedere a Microsoft Visual Basic for Applications.
  • Accedere al progetto di Outlook: nel riquadro laterale espandere Project1 e fare doppio clic su ThisOutlookSession.
  • Copiare il seguente codice VBA e incollarlo nella finestra di codice. Numerosi commenti rendono il codice ben documentato e facilmente leggibile

Option Explicit
' Istruzione fondamentale: richiede che TUTTE le variabili siano dichiarate prima di essere usate.
' Questo aiuta a prevenire errori di battitura (bug) nel codice.

' --- DICHIARAZIONI GLOBALI (a livello di modulo) ---

Public WithEvents xExplorer As Outlook.Explorer
' Dichiara una variabile 'xExplorer' che rappresenta la finestra principale di Outlook
' (dove vedi la lista delle email). 'WithEvents' permette di "ascoltare" cosa succede in quella finestra.

Public WithEvents xMailItem As Outlook.MailItem
' Dichiara una variabile 'xMailItem' che rappresenta l'email che è attualmente selezionata.
' 'WithEvents' ci permette di "ascoltare" l'azione "Rispondi" su quell'email specifica.

' --- GESTIONE AVVIO APPLICAZIONE ---

Sub Application_Startup()
    ' Questa funzione viene eseguita automaticamente non appena apri Outlook.
    Set xExplorer = Outlook.Application.ActiveExplorer
    ' Assegna alla variabile 'xExplorer' la finestra di Outlook attualmente attiva.
End Sub

' --- GESTIONE SELEZIONE (Monitora il cambio di email) ---

Private Sub xExplorer_SelectionChange()
    ' Questa funzione viene eseguita ogni volta che cambi la selezione nella lista delle email.
    
    ' Nota: il codice originale conteneva una riga "Call ReplySelectedMail(xExplorer)" che è stata rimossa
    ' o sostituita dal blocco seguente, che è la versione pulita per assegnare l'oggetto.
    
    On Error Resume Next
    ' Istruzione temporanea: se si verifica un errore (es. selezioni qualcosa che non è un'email),
    ' ignora l'errore e passa alla riga successiva. Necessario qui perché la selezione può essere complessa.
    
    If xExplorer.Selection.Count = 1 Then
        ' Controlla: se hai selezionato un SOLO elemento...
        If TypeOf xExplorer.Selection.Item(1) Is Outlook.MailItem Then
            ' E se quell'elemento è un'Email (MailItem)...
            Set xMailItem = xExplorer.Selection.Item(1)
            ' ...allora assegna quell'email alla variabile 'xMailItem' per poter intercettare il 'Reply'.
        Else
            Set xMailItem = Nothing
            ' Altrimenti, se hai selezionato un calendario o una cartella, rilascia la variabile.
        End If
    Else
        Set xMailItem = Nothing
        ' Se hai selezionato più di un elemento o nessuno, rilascia la variabile.
    End If
    
    On Error GoTo 0
    ' Disattiva l'istruzione temporanea di gestione degli errori per le righe successive.
End Sub

' --- AZIONE PRINCIPALE: L'EVENTO "RISPONDI" ---

Private Sub xMailItem_Reply(ByVal Response As Object, Cancel As Boolean)
    ' Questa funzione viene eseguita solo quando premi il pulsante "Rispondi"
    ' sull'email che è stata selezionata.

    ' --- DICHIARAZIONE VARIABILI LOCALI ---
    Dim xNameSpace As Outlook.NameSpace         ' Per accedere alle cartelle di Outlook (es. Contatti).
    Dim xContactItems As Outlook.Items          ' L'intera collezione di elementi nella cartella Contatti.
    Dim xContact As Outlook.ContactItem         ' Un contatto esistente trovato.
    Dim xNewContact As Outlook.ContactItem      ' Un nuovo contatto da creare.
    Dim xRecipients As Outlook.Recipients       ' La lista di destinatari (A:, Cc:, Ccn:).
    Dim xRecipient As Outlook.Recipient         ' Un singolo destinatario della lista.
    Dim xDictAddresses As Object                ' Strumento avanzato (Dizionario) per tenere traccia
                                                ' degli indirizzi già visti ed evitare duplicati.
    Dim xAddress As Variant                     ' Usato per scorrere gli indirizzi nel Dizionario.
    Dim sName As String                         ' Nome della persona (Mittente o Destinatario).
    Dim sAddress As String                      ' Indirizzo email.
    Dim sFilterAddress As String                ' La stringa di ricerca per trovare i contatti esistenti.
    Dim lIdx As Long                            ' Un contatore per i cicli.

    ' --- 1. PREPARAZIONE E RACCOLTA INDIRIZZI ---

    Set xDictAddresses = CreateObject("Scripting.Dictionary")
    ' Crea il Dizionario (uno strumento per archiviare indirizzi unici: "Indirizzo" -> "Nome").
    
    ' A. Aggiungi il Mittente (Sender)
    sAddress = xMailItem.SenderEmailAddress
    sName = xMailItem.SenderName
    If Not xDictAddresses.Exists(sAddress) And sAddress <> "" Then
        ' Se l'indirizzo del Mittente NON è già nel Dizionario e non è vuoto...
        xDictAddresses.Add sAddress, sName
        ' ...allora aggiungilo (chiave: indirizzo, valore: nome).
    End If

    ' B. Aggiungi tutti i Destinatari (Recipients)
    Set xRecipients = xMailItem.Recipients
    For Each xRecipient In xRecipients
        ' Scorre tutti i destinatari (A:, Cc:, Ccn:)
        xRecipient.Resolve ' Assicura che l'indirizzo sia risolto (se non lo è già)
        sAddress = xRecipient.Address
        sName = xRecipient.Name
        If Not xDictAddresses.Exists(sAddress) And sAddress <> "" Then
            ' Se l'indirizzo del Destinatario NON è già nel Dizionario e non è vuoto...
            xDictAddresses.Add sAddress, sName
            ' ...allora aggiungilo.
        End If
    Next xRecipient

    ' --- 2. ACCESSO ALLA RUBRICA ---

    Set xNameSpace = Outlook.Application.GetNamespace("MAPI")
    ' Si connette al sistema di archiviazione di Outlook (MAPI).
    Set xContactItems = xNameSpace.GetDefaultFolder(olFolderContacts).Items
    ' Ottiene la collezione di tutti gli elementi (Contatti) nella cartella "Contatti" predefinita.

    ' --- 3. CONTROLLO ESISTENZA E CREAZIONE CONTATTI ---

    For Each xAddress In xDictAddresses.Keys
        ' Scorre tutti gli indirizzi UNICI raccolti (Mittente + Destinatari).
        sAddress = CStr(xAddress)
        sName = CStr(xDictAddresses.Item(xAddress))
        
        Set xContact = Nothing
        ' Resetta la variabile per la ricerca del contatto prima di ogni tentativo.
        
        ' Cerca se l'indirizzo esiste nei campi EmailAddress (Outlook ne gestisce fino a 3: Email1, Email2, Email3)
        For lIdx = 1 To 3
            ' Il ciclo controlla i 3 possibili campi email del contatto.
            
            sFilterAddress = "[Email" & lIdx & "Address] = '" & Replace(sAddress, "'", "''") & "'"
            ' Costruisce la stringa di ricerca. Ad esempio: "[Email1Address] = 'pippo@example.com'".
            ' Il 'Replace' serve a gestire indirizzi che contengono apici (molto raro, ma sicuro).
            
            Set xContact = xContactItems.Find(sFilterAddress)
            ' Esegue la ricerca vera e propria nella rubrica.
            
            If Not (xContact Is Nothing) Then
                Exit For
                ' Se ha trovato il contatto (non è 'Nothing'), esce dal ciclo 1-3.
            End If
        Next lIdx
        
        ' Se il contatto NON è stato trovato dopo tutti i controlli (xContact è ancora Nothing)...
        If xContact Is Nothing Then
            Set xNewContact = Outlook.Application.CreateItem(olContactItem)
            ' Crea un NUOVO oggetto Contatto.
            With xNewContact
                ' Imposta le proprietà del nuovo contatto.
                .FullName = sName           ' Imposta il nome completo.
                .Email1Address = sAddress   ' Imposta l'indirizzo email principale.
                .Categories = "From Email"  ' Aggiunge la categoria 'From Email' per identificarlo facilmente.
                .Save                       ' Salva il nuovo contatto nella rubrica.
            End With
        End If
    Next xAddress
    
    ' --- 4. PULIZIA FINALE ---
    
    Set xDictAddresses = Nothing
    Set xRecipients = Nothing
    Set xContactItems = Nothing
    Set xNameSpace = Nothing
    ' Rilascia tutti gli oggetti utilizzati per liberare la memoria.
    
End Sub

  • Salvare e riavviare Outlook. Al riavvio, la macro sarà attiva e funzionante.

Outlook, Microsoft Visual Basic
FIG 1 - Outlook, Microsoft Visual Basic

Da questo momento, ogni volta che si risponde a un’email, il sistema salverà automaticamente il mittente e tutti i destinatari come nuovi contatti all’interno della cartella predefinita associata all’account di posta.


Considerazioni di sicurezza e governance

È bene sottolineare che l’utilizzo di macro VBA in Outlook può essere soggetto a policy di sicurezza aziendali. In molte organizzazioni, infatti, l’esecuzione di codice personalizzato è limitata per ridurre i rischi di attacchi tramite macro. Prima di implementare questa soluzione in un contesto enterprise, è quindi opportuno:

  • Verificare le impostazioni di sicurezza di Outlook e le eventuali restrizioni IT.
  • Valutare l’impatto sulla gestione centralizzata dei contatti, soprattutto se si utilizzano sistemi integrati come Microsoft Exchange o Microsoft 365.



mercoledì 1 ottobre 2025

Git: Annullare le operazioni

Durante lo sviluppo, può capitare di voler annullare una modifica o correggere un errore. Git offre diversi strumenti per gestire queste situazioni, ma è fondamentale utilizzarli con cautela: alcune operazioni di undo non sono reversibili e, se usate in modo improprio, possono comportare la perdita definitiva di lavoro.


Correggere l’ultimo commit con --amend

Uno degli scenari più comuni si verifica quando si effettua un commit troppo presto, dimenticando di includere un file o inserendo un messaggio di commit errato. In questi casi, Git consente di sostituire l’ultimo commit con uno nuovo tramite l’opzione --amend:

git commit --amend

Git prende il contenuto dell’area di staging (index) e lo utilizza per generare un nuovo commit.

Se non sono state aggiunte nuove modifiche dallo scorso commit, verrà riaperto semplicemente l’editor dei messaggi di commit, consentendo di modificarlo.


Esempio pratico

Supponiamo di aver eseguito il commit e di esserci resi conto di aver dimenticato di inserire le modifiche in un file che volevamo aggiungere a questo commit. Possiamo rimediare aggiungendo il file con git add e rieseguire il commit con git commit --amend:

git commit -m "Initial commit"
git add file_dimenticato
git commit --amend

Il repository avrà un solo commit, che include anche file_dimenticato. Il commit precedente viene sovrascritto e sparisce dalla cronologia.


Aspetti importanti da considerare
  • Sostituzione, non modifica 
    - Amend non aggiorna un commit già esistente ma lo sostituisce con un nuovo commit dotato di un nuovo identificativo (SHA-1).
    - Di fatto, è come se il commit precedente non fosse mai esistito.
  • Pulizia della cronologia
    - L’opzione --amend è utile per evitare commit ridondanti.
  • Limitazione: solo commit locali
    - È fortemente sconsigliato eseguire git commit --amend su commit già pubblicati (pushed) in un repository remoto. Infatti, l’operazione riscrive la cronologia e, se accompagnata da un git push --force, può creare conflitti e problemi per gli altri collaboratori.


Tabella di sintesi: git commit --amend

ScenarioComandoRisultato
Modificare solo il messaggio di commitgit commit --amend (senza nuovi file in staging)Sovrascrive il messaggio dell’ultimo commit
Aggiungere file dimenticatigit add file + git commit --amendCrea un nuovo commit che sostituisce il precedente includendo anche file
Commit già pushato sul remotogit commit --amend + git push --forceSconsigliato: riscrive la cronologia e può rompere il lavoro dei collaboratori


Rimuovere un File dall’Area di Staging

Durante il lavoro quotidiano con Git, può capitare di inserire per errore più file nell’area di staging (index) utilizzando un comando troppo generico, come ad esempio:

git add *

In questo caso, se l’obiettivo era committare i file separatamente, è necessario rimuovere uno o più file dallo staging (unstaging), riportandoli allo stato di semplici modifiche nella working directory.

A partire dalla versione 2.23.0, Git ha introdotto il comando git restore, concepito come alternativa più intuitiva e leggibile rispetto a git reset per alcune operazioni di annullamento (undo).

L’obiettivo di questo nuovo comando è semplificare la sintassi e ridurre i rischi legati a usi impropri di git reset, che in passato potevano facilmente portare alla perdita involontaria di dati.

la differenza principale tra git restore e git reset HEAD sta nel loro scopo e nell'ambito d'azione:

  • git restore è un comando moderno e più sicuro, ideato per ripristinare i file nello stato in cui si trovavano in una versione precedente. Agisce sulla working directory (area di lavoro) o sulla staging area (area di "preparazione" prima del commit), ma non modifica la cronologia dei commit. È l'ideale per annullare modifiche locali, che non sono ancora state salvate nella cronologia.
  • git reset HEAD è un comando più vecchio, versatile e potente, che agisce primariamente sulla cronologia dei commit. Sposta il puntatore HEAD a un commit precedente, e di conseguenza, può influenzare l'area di staging e l'area di lavoro a seconda dell'opzione utilizzata (--soft, --mixed, o --hard). È uno strumento più "distruttivo" e va usato con cautela, specialmente su branch condivisi, perché modifica la storia del repository.


Identificare i file in staging con git status

Il comando git status non solo mostra lo stato della working directory e dell’area di staging, ma fornisce anche indicazioni utili su come annullare operazioni indesiderate.

Esempio pratico:

Per individuare il file da rimuovere all'area di staging

git status

git status
FIG 1 - git status

Come si può notare da FIG 1 , Git suggerisce direttamente il comando corretto per rimuovere un file dallo staging.

git restore --staged <file>

Nel nostro caso, per rimuovere il file main.cs dallo staging il comando sarà

git restore --staged main.cs

git restore --staged
FIG 2 - git restore --staged


Lo stesso risultato lo si ottiene con 

git reset HEAD <file>

Il comando git reset è spesso considerato pericoloso, poiché con opzioni come --hard può portare alla perdita definitiva di modifiche locali. Tuttavia, in questo scenario, l’uso di git reset HEAD è sicuro perché non modifica i contenuti della working directory ma agisce esclusivamente sull’indice, rimuovendo il file dallo staging.


Tabella di sintesi: Comandi per gestire lo staging

ComandoEffetto
git add fileAggiunge un file all’area di staging
git reset HEAD fileRimuove il file dallo staging, mantenendo le modifiche nella working directory
git restore --staged fileAlternativa moderna a git reset HEAD file, con la stessa funzione
git reset --hardPericoloso: annulla anche le modifiche nella working directory


 

Annullare le modifiche a un File

Può capitare di accorgersi che le modifiche apportate a un file non sono più necessarie e che si desidera ripristinare il contenuto all’ultima versione tracciata da Git (ossia l’ultima presente nell’area di staging o nel commit più recente).

In questi casi, Git mette a disposizione due comandi storicamente equivalenti, ma con differenze importanti: git restore (introdotto in Git ≥ 2.23.0) e git checkout (metodo tradizionale).


Esempio pratico con git restore

Supponiamo di aver modificato il file main.cs. Eseguiamo il comando

git status

git status
FIG 3 - git status

Per annullare le modifiche non salvate:

git restore main.cs

Dopo il comando, il file torna allo stato dell’ultimo commit o staging, eliminando definitivamente i cambiamenti locali.

git restore
FIG 4 - git restore


Esempio pratico con git checkout

git checkout -- main.cs

Anche in questo caso il file viene ripristinato, cancellando le modifiche locali.

git checkout
FIG 5 - git checkout



Differenze tra git restore e git checkout

Caratteristicagit restoregit checkout
DisponibilitàIntrodotto in Git ≥ 2.23.0Presente in tutte le versioni di Git
ObiettivoProgettato specificamente per annullare modifiche ai file (working directory e staging)Comando multifunzione (cambio branch, ripristino file, navigazione)
Chiarezza sintatticaPiù leggibile e autoesplicativo (restore indica chiaramente lo scopo)Sintassi più generica e meno intuitiva
Rischio di confusioneRidotto: il comando è dedicato solo al ripristinoElevato: git checkout gestisce operazioni molto diverse tra loro
Best PracticeConsigliato nei workflow moderni per annullare modifiche localiAncora valido, ma da usare con cautela per evitare ambiguità


Attenzione

  • Entrambi i comandi cancellano in modo irreversibile le modifiche locali non ancora salvate in un commit.
  • Prima di utilizzarli, è opportuno chiedersi se le modifiche possano essere utili in futuro.
  • In alternativa, si può ricorrere a git stash o a un nuovo branch, salvando temporaneamente i cambiamenti senza perderli.

È importante ricordare che soltanto ciò che è stato effettivamente sottoposto a commit può essere recuperato; le modifiche non salvate andranno invece perse in maniera definitiva.

In Git, i dati oggetto di commit risultano quasi sempre recuperabili, anche qualora appartengano a rami successivamente eliminati oppure siano stati sovrascritti tramite l’opzione --amend. Tutte le modifiche non ancora committate e andate perse non potranno, con ogni probabilità, essere ripristinate.


Best Practice

  • Usare git restore nei progetti moderni: più chiaro e meno soggetto a errori.
  • Evitare git checkout -- <file> se non strettamente necessario: mantiene la retrocompatibilità, ma può confondere.
  • Ricorrere a git stash o ai branch per soluzioni temporanee: ideale se non si vuole perdere il lavoro fatto.



domenica 28 settembre 2025

Git: Consultazione della Cronologia dei Commit

Dopo aver effettuato diversi commit, oppure quando si clona un repository con una cronologia già esistente, è fondamentale poter analizzare lo storico delle modifiche.

Lo strumento principale messo a disposizione da Git per questo scopo è il comando git log, che consente di ispezionare in dettaglio l’evoluzione di un progetto.

Il comando più semplice è:

git log

L’output predefinito elenca i commit in ordine cronologico inverso, mostrando per ciascun commit:

  • l’hash SHA-1 univoco
  • l’autore con email
  • la data
  • il messaggio di commit

git log
FIG 1 - git log

Opzioni utili di git log

Git mette a disposizione un’ampia gamma di opzioni per adattare l’output alle proprie esigenze.

1. Mostrare le modifiche introdotte da ciascun commit
git log -p -2
  • L’opzione -p (o --patch) visualizza le differenze introdotte.
  • Il parametro -2 limita l’output agli ultimi due commit.
  • Utile in fase di code review o per analizzare l’evoluzione del codice.
git log -p -2
FIG 2 - git log -p -2

2. Visualizzare statistiche sintetiche

git log --stat

Mostra i file modificati, il numero di righe aggiunte/rimosse e un riepilogo finale.
git log --stat
FIG 3 - git log --stat
git log --shortstat
Questo comando fornisce un riassunto molto conciso per ogni commit. Mostra un'unica riga con il conteggio totale dei file modificati e il numero totale di righe aggiunte e cancellate. Non elenca i nomi specifici dei file.

3. Formattazione personalizzata

Consente di definire un formato personalizzato dell’output, utile per generare report o output leggibili da script.
git log --pretty=format:"%h - %an, %ar : %s"

Segnaposto principali

SegnapostoDescrizione
%HHash completo del commit
%hHash abbreviato
%THash dell'albero
%tHash dell'albero abbreviato
%PHash dei genitori
%pHash dei genitori abbreviati
%anNome autore
%aeEmail autore
%adData autore (formato configurabile con --date=)
%arData autore relativa (es. “2 weeks ago”)
%cnNome committer
%ceEmail committer
%cdData del committer
%crData del committer, relativa
%sMessaggio del commit
git log --pretty=format
FIG 4 - git log --pretty=format

4. Output compatti
  • git log --oneline
    commit in una sola riga (hash abbreviato + messaggio).
  • git log --pretty=short|full|fuller
    diversi livelli di dettaglio.
  • git log --abbrev-commit
    mostra solo le prime cifre dell’hash.
git log --oneline
FIG 5 - git log --oneline

5. Rappresentazione grafica

Visualizza un grafico ASCII che illustra la struttura di branch e merge, molto utile in repository complessi.
git log --graph
git log --graph
FIG 6 - git log --graph

Opzioni per limitare l'output di git log

Oltre alle opzioni di formattazione, il comando git log supporta numerose opzioni di limitazione, che consentono di filtrare i commit mostrati.
Queste opzioni sono utili per concentrarsi su un intervallo temporale, un autore, un file specifico o persino su modifiche particolari al codice.

1. Limitazione numerica

Per visualizzare solo gli ultimi n commit:

git log -2
Mostra solo gli ultimi due commit.
git log -2
FIG 7 - git log -2



2. Limitazione temporale

È possibile filtrare i commit in base a date assolute o relative:

git log --since=2.weeks
git log --since="2025-01-01" --until="2025-01-31"


--since / --after  
commit successivi a una certa data.

--until / --before 
commit precedenti a una certa data.

Esempi validi di date:
"2008-01-15" (formato ISO)
"2 years 1 day 3 minutes ago" (relativo)



3. Filtrare per autore o committer

git log --author="Alice"
git log --committer="Bob"

--author  
mostra commit scritti da un certo autore.

--committer
mostra commit applicati da uno specifico committer.

É possibile utilizzare più di una regola --author o --grep contemporaneamente.
Con l’opzione --all-match, Git mostrerà solo i commit che soddisfano tutti i criteri.



4. Ricerca nei messaggi di commit

git log --grep="bugfix"

Mostra i commit che hanno "bugfix" nel messaggio di commit.
Può essere combinato con --author e --since per ricerche più precise.



5. Pickaxe: cercare modifiche nel codice

git log -S function_name

L’opzione -S (detta pickaxe) trova i commit in cui cambia il numero di occorrenze di una stringa (es. aggiunta o rimozione di una funzione).
Ottimo per capire quando e perché è stata introdotta o rimossa una porzione di codice.



6. Limitazione per file o directory

git log -- path/to/file

Mostra solo i commit che hanno modificato un file o una directory specifica.
Per separare chiaramente le opzioni dal percorso si usa --:

git log --since="2025-01-01" -- path/to/file



7. Evitare i merge commit

In repository con workflow basati su merge, la cronologia può risultare affollata.
Per nascondere i merge commit non informativi:

git log --no-merges


Tabelle riepilogative delle opzioni comuni

OpzioneDescrizione
-p o --patchMostra le differenze introdotte da ciascun commit
--statRiepilogo file modificati e righe aggiunte/rimosse
--shortstatSolo il riepilogo numerico (senza elenco file)
--name-onlyElenco dei file modificati
--name-statusElenco file + stato (A=Added, M=Modified, D=Deleted)
--abbrev-commitHash abbreviati
--relative-dateDate in formato relativo (“2 days ago”)
--graphGrafico ASCII della cronologia
--prettyFormati alternativi (oneline, short, full, fuller, format)
--onelineAlias di --pretty=oneline --abbrev-commit. Mostra ogni commit su una singola riga 


Opzioni di filtro

OpzioneDescrizione
-n <numero>Limita il numero di commit visualizzati all'ultimo <numero> specificato
--author="<pattern>"Filtra i commit in base all'autore. Accetta anche espressioni regolari.
--committer="<pattern>"Filtra i commit in base al committer.
--grep="<pattern>"Filtra i commit in base a un pattern nel messaggio del commit.
--since="<data>"Visualizza i commit a partire da una data specificata("2 weeks ago", "2023-01-01", "yesterday").
--until="<data>"Visualizza i commit fino a una data specificata.
--after="<data>"Alias di --since
--before="<data>"Alias di --until
<file-o-cartella>Mostra solo i commit che hanno modificato un file o una cartella specifica
--mergesMostra solo i commit di merge.
--no-mergesEsclude i commit di merge dalla visualizzazione.


Opzioni di navigazione

OpzioneDescrizione
--reverseLimita il numero di commit visualizzati all'ultimo <numero> specificato
<start>..<end>Filtra i commit in base all'autore. Accetta anche espressioni regolari.
-S"<stringa>"
o --all-match-S"<stringa>"
Mostra i commit che hanno introdotto o rimosso una riga contenente una stringa specifica. Utile per il debugging.
-G"<regex>"Simile a -S, ma usa un'espressione regolare per cercare le modifiche nel contenuto dei file



Differenza tra autore e committer

  • Autore (Author): chi ha scritto originariamente la modifica.
  • Committer: chi ha applicato la modifica al repository (può coincidere con l’autore o essere un maintainer che ha accettato una patch).

Questo permette di riconoscere sia chi ha prodotto il codice sia chi ne ha garantito l’integrazione


Esempio avanzato

Visualizzare i commit:

  • scritti da Giovanni Lubrano Lavadera,
  • nel mese di novembre 2024,
  • che non siano merge commit,
  • relativi alla directory test/
git log --pretty="%h - %s" \ --author="Giovanni Lubrano Lavadera" \ --since="2024-11-01" \ --before="2024-12-01" \ --no-merges -- test/