Risolvere i conflitti di unione

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Quando si unisce o si esegue la ribase, git sta dicendo a Git di integrare le modifiche apportate in un ramo con le modifiche apportate in un altro. Spesso Git completa automaticamente un'operazione di merge o ribase senza assistenza. Tuttavia, se Git rileva che una modifica apportata in un ramo è in conflitto con una modifica apportata a un'altra, richiede di risolvere il conflitto. Un conflitto di merge può verificarsi quando i rami uniti modificano la stessa riga di file in modo diverso o quando un ramo modifica un file e un altro ramo lo elimina. Il processo per la risoluzione dei conflitti di merge è applicabile sia all'unione git che alla rebase.

È possibile risolvere i conflitti di unione in Visual Studio oppure usando la riga di comando e qualsiasi editor di testo.

Per una panoramica del flusso di lavoro Git, vedere Esercitazione su Git di Azure Repos.

Questo articolo illustra le procedure per le attività seguenti:

• Informazioni sui conflitti di unione
• Risolvere i conflitti di unione

Informazioni sui conflitti di unione

L'unione git o la rebase integra i commit da un ramo di origine nel ramo locale corrente (ramo di destinazione). L'unione Git esegue un'operazione di merge fast forward o no-fast-forward. L'unione senza inoltro rapido è nota anche come unione a tre vie o vera unione. La rebase Git è un altro tipo di merge. Questi tipi di unione sono illustrati nel diagramma seguente.

Per l'unione Git, se il suggerimento del ramo di destinazione esiste all'interno del ramo di origine, il tipo di unione predefinito sarà un merge con inoltro rapido. In caso contrario, il tipo di unione predefinito sarà un'unione senza inoltro rapido.

Un'unione con avanzamento rapido non può mai avere un conflitto di merge perché Git non applicherà un merge rapido se la punta del ramo di destinazione si è discosta dal ramo di origine. Per impostazione predefinita, Git usa un'unione rapida ogni volta che possibile. Ad esempio, Git applicherà un merge fast forward in un ramo locale che viene aggiornato solo eseguendo il pull dal ramo controparte remota.

Un'unione no-fast-forward genera un nuovo ramo di destinazione "commit di merge" che integra le modifiche del ramo di origine con le modifiche del ramo di destinazione. Le modifiche applicabili sono quelle apportate dopo l'ultimo commit comune a entrambi i rami. Nel diagramma precedente il commit C è l'ultimo commit comune in entrambi i rami. Se una modifica del ramo di origine è in conflitto con qualsiasi modifica del ramo di destinazione, Git chiederà di risolvere il conflitto di merge. Il commit di merge (L) contiene le modifiche del ramo di origine integrato e del ramo di destinazione. I suggerimenti per il ramo di origine e di destinazione (K e E) sono gli elementi padre del commit di merge. Nella cronologia dei commit del ramo, un commit di merge è un indicatore utile per un'operazione di merge e mostra chiaramente quali rami sono stati uniti.

Git esegue nuovamente la ribase della cronologia dei commit del ramo di destinazione in modo che contenga tutti i commit del ramo di origine, seguiti da tutti i commit del ramo di destinazione dall'ultimo commit comune. Nel diagramma precedente il commit C è l'ultimo commit comune in entrambi i rami. Un altro modo per visualizzare è che una ribase riproduce le modifiche nel ramo di destinazione sopra la cronologia dei rami di origine. Se una modifica del ramo di origine è in conflitto con qualsiasi modifica del ramo di destinazione, Git chiederà di risolvere il conflitto di merge. Come per l'unione a inoltro rapido, una rebase non crea un commit di merge. In particolare, una rebase modifica la sequenza dei commit del ramo di destinazione esistente, che non è il caso per le altre strategie di merge. Nel diagramma precedente, commit K' contiene le stesse modifiche di K, ma ha un nuovo ID commit perché si collega di nuovo al commit E invece di C.

L'unione e la ribase git modificano solo il ramo di destinazione. Il ramo di origine rimane invariato. Quando si verificano uno o più conflitti di unione, è necessario risolverli per completare l'unione o la rebase. In alternativa, è possibile annullare l'operazione di merge/ribase e restituire il ramo di destinazione allo stato precedente.

Per altre informazioni sulle opzioni e sulle strategie di merge, vedere le strategie di riferimento git manuali e Git merge.

Quando risolvere i conflitti di merge

L'unione git e la rebase Git vengono ampiamente usate nel flusso di lavoro Git. Quando si lavora su una funzionalità locale o un ramo di correzione di bug, è pratica comune:

1. Mantenere aggiornato il ramo locale main con la controparte remota eseguendo periodicamente il pull per recuperare e unire i commit remoti.
2. Integrare gli aggiornamenti del ramo locale main nel ramo di funzionalità locale usando una ribase o unisci.
3. Eseguire il backup del lavoro nel ramo di funzionalità locale eseguendo il push nel ramo remoto corrispondente.
4. Al termine della funzionalità, creare una richiesta pull per unire il ramo di funzionalità remoto nel ramo remoto main .

Integrando spesso le modifiche remote nel repository locale, è possibile rimanere a conoscenza del lavoro recente da parte di altri utenti e risolvere tempestivamente eventuali conflitti di merge che si verificano.

Risolvere i conflitti di unione

Il processo per la risoluzione dei conflitti di merge è applicabile sia all'unione Git che alla rebase Git. Anche se i passaggi seguenti descrivono come risolvere i conflitti di unione durante un'unione, è possibile risolvere in modo analogo i conflitti di merge durante una ribase.

Suggerimento

Se il ramo di origine è un ramo di rilevamento remoto, assicurarsi che il ramo sia aggiornato eseguendo un recupero Git prima di un merge. In alternativa, eseguire il comando git pull , che combina un recupero Git con un'unione Git.

Visual Studio 2022

Visual Studio 2022 offre un'esperienza di controllo della versione Git usando il menu Git, Le modifiche Git e tramite i menu di scelta rapida in Esplora soluzioni. Visual Studio 2019 versione 16.8 offre anche l'interfaccia utente Git di Team Explorer . Per altre informazioni, vedere la scheda Visual Studio 2019 - Team Explorer .

1. Nel riquadro Rami della finestra Repository Git eseguire il checkout del ramo di destinazione. Fare quindi clic con il pulsante destro del mouse sul ramo di origine e scegliere Merge source-branch into target-branch .Then right-click the source branch and choose Merge source-branch into <target-branch>>.<

   

2. Visual Studio invierà una notifica se Git ha interrotto l'unione a causa di conflitti. In tal caso, è possibile risolvere i conflitti oppure annullare l'unione e tornare allo stato di pre-unione. La sezione Modifiche non salvate della finestra Modifiche Git elenca i file con conflitti di unione. Per un file con conflitti di unione nel relativo contenuto, fare doppio clic sul file per aprirlo nell'editor di merge.

   

3. Nell'editor di merge il riquadro In ingresso mostra la versione del file del ramo di origine, il riquadro Corrente mostra la versione del file del ramo di destinazione e il riquadro Risultato mostra il file di unione risultante. Per applicare modifiche specifiche al ramo di origine o di destinazione, selezionare la casella di controllo accanto alle righe in conflitto che si desidera mantenere. È anche possibile modificare direttamente il file di unione nel riquadro Risultati . Scegliere Accetta unione dopo aver risolto tutti i conflitti di unione nel file corrente. Ripetere questo passaggio per ogni file con conflitti di contenuto.

   

4. Per un file modificato in un ramo ed eliminato nell'altro, fare clic con il pulsante destro del mouse sul file e selezionare l'azione di ramo desiderata.

   

5. Nella finestra Modifiche Git immettere un messaggio di commit e scegliere Commit staged per completare l'unione, dopo aver risolto tutti i conflitti di unione per tutti i file.

   

Visual Studio 2019 - Menu Git

Visual Studio 2019 offre un'esperienza di controllo della versione Git usando il menu Git, Le modifiche Git e i menu di scelta rapida in Esplora soluzioni.

1. Nel riquadro Rami della finestra Repository Git eseguire il checkout del ramo di destinazione. Fare quindi clic con il pulsante destro del mouse sul ramo di origine e scegliere Merge source-branch into target-branch .Then right-click the source branch and choose Merge source-branch into <target-branch>>.<

   

2. Visual Studio invierà una notifica se Git ha interrotto l'unione a causa di conflitti. In tal caso, è possibile risolvere i conflitti oppure annullare l'unione e tornare allo stato di pre-unione. La sezione Modifiche non salvate della finestra Modifiche Git elenca i file con conflitti di unione. Per un file con conflitti di unione nel relativo contenuto, fare doppio clic sul file per aprirlo nell'editor di merge.

   

3. Nell'editor di merge il riquadro In ingresso mostra la versione del file del ramo di origine, il riquadro Corrente mostra la versione del file del ramo di destinazione e il riquadro Risultato mostra il file di unione risultante. Per applicare modifiche specifiche al ramo di origine o di destinazione, selezionare la casella di controllo accanto alle righe in conflitto che si desidera mantenere. È anche possibile modificare direttamente il file di unione nel riquadro Risultati . Scegliere Accetta unione dopo aver risolto tutti i conflitti di unione nel file corrente. Ripetere questo passaggio per ogni file con conflitti di contenuto.

   

4. Per un file modificato in un ramo ed eliminato nell'altro, fare clic con il pulsante destro del mouse sul file e selezionare l'azione di ramo desiderata.

   

5. Nella finestra Modifiche Git immettere un messaggio di commit e scegliere Commit staged per completare l'unione, dopo aver risolto tutti i conflitti di unione per tutti i file.

   

Visual Studio 2019 - Team Explorer

Visual Studio 2019 versione 16.8 e versioni successive offre un'esperienza di controllo della versione Git mantenendo al tempo stesso l'interfaccia utente git di Team Explorer . Per usare Team Explorer, deselezionare Strumenti>Opzioni>anteprima Funzionalità>Nuova esperienza utente Git dalla barra dei menu. È possibile usare le funzionalità Git da entrambe le interfacce in modo intercambiabile.

1. Nella visualizzazione Rami di Team Explorer eseguire il checkout del ramo di destinazione. Fare quindi clic con il pulsante destro del mouse sul ramo di origine e scegliere Unisci da.

   

2. Verificare le opzioni di unione e quindi fare clic su Unisci.

   

3. Visual Studio invierà una notifica se Git ha interrotto l'unione a causa di conflitti. In tal caso, è possibile risolvere i conflitti oppure annullare l'unione e tornare allo stato di pre-unione. Per risolvere i conflitti, scegliere Conflitti per aprire la visualizzazione Risolvi conflitti .

   

4. Nella visualizzazione Risolvi conflitti sono elencati i file con conflitti di unione. Selezionare un file dall'elenco per visualizzare le opzioni di risoluzione per il file.

   

5. Per un file con conflitti di unione nel contenuto, selezionare Unisci per aprirlo nell'editor di merge.

   

6. Nell'editor di merge il riquadro Origine mostra la versione del file del ramo di origine, il riquadro Destinazione mostra la versione del file del ramo di destinazione e il riquadro Risultato mostra il file di unione risultante. Per applicare modifiche specifiche al ramo di origine o di destinazione, selezionare la casella di controllo accanto alle righe in conflitto che si desidera mantenere. È anche possibile modificare direttamente il file di unione nel riquadro Risultati . Scegliere Accetta unione dopo aver risolto tutti i conflitti di unione nel file corrente. Ripetere questo passaggio per ogni file con conflitti di contenuto.

   

7. Per un file modificato in un ramo ed eliminato nell'altro, selezionare l'azione di ramo desiderata.

   

8. Nella visualizzazione Risolvi conflitti scegliere Esegui commit unione dopo aver risolto tutti i conflitti di unione per tutti i file.

   

9. Nella visualizzazione Modifiche di Team Explorer immettere un messaggio di commit e scegliere Commit Stagingd per completare l'unione.

   

Riga di comando Git

Prima di unire un ramo di origine in un ramo di destinazione, eseguire il checkout del ramo di destinazione. Usare quindi il comando Git merge per unire il ramo di origine nel ramo locale corrente (ramo di destinazione). Per unire più rami di origine in un ramo di destinazione, separare i nomi dei rami di origine con gli spazi.

git checkout <target branch>
git merge <source branch>

Suggerimento

È anche possibile usare git switch <branch name> per passare a un ramo.

Alcuni scenari causeranno l'esito negativo del comando git merge con un errore o l'interruzione prima del completamento.

Messaggio Git	Descrizione	Risoluzione
Le modifiche locali ai file seguenti verranno sovrascritte dal merge...	Questo errore indica che il ramo locale corrente ha uno o più file con modifiche di cui non è stato eseguito il commit e che tali file sono interessati dall'unione. Git non genererà un errore per le modifiche di cui non è stato eseguito il commit nei file che non sono interessati dall'unione.	Eseguire il commit, lo stash o rimuovere le modifiche di cui non è stato eseguito il commit, quindi ripetere l'operazione di merge.
Unione automatica non riuscita; correggere i conflitti e quindi eseguire il commit del risultato.	Almeno un ramo di origine è in conflitto con una modifica del ramo di destinazione. Git interrompe l'unione e attende di risolvere i conflitti di merge.	Annullare l'unione eseguendo git merge --aborto risolvere tutti i conflitti di merge, quindi eseguire git merge --continue.

Suggerimento

Per l'operazione di unione corrente, è possibile:

• Eseguire git status per elencare i file con conflitti di unione.
• Eseguire git log --merge per elencare i commit in conflitto nei rami di origine e di destinazione.

Risolvere i conflitti di contenuto dei file

1. Aprire un file in qualsiasi editor per visualizzare e risolvere il testo in conflitto. Git ha aggiunto un set di marcatori per indicare le istanze di testo in conflitto. Ad esempio:

   <<<<<<< HEAD
   - Network controller
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switches
   =======
   - Network control
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switch
   >>>>>>> origin/main
   

   Il testo tra <<<<<<< e ======= è la versione del ramo di destinazione del testo in conflitto.
   Il testo tra ======= e >>>>>>> è la versione del ramo di origine del testo in conflitto.

2. Modificare il file per risolvere il testo in conflitto. Rimuovendo i marcatori di conflitto di merge, si informa Git che il conflitto è stato risolto. Ad esempio, è possibile modificare il testo precedente (inclusi i marcatori di conflitto) in:

   - Network controller
   - Fiber optic transmitter
   - Fiber optic transceiver
   - Network switch
   

3. Eseguire git add <filename> per preparare il file dopo aver risolto tutto il testo in conflitto.

4. Ripetere i passaggi precedenti per tutti i file con conflitti di contenuto.

Risolvere i conflitti di file eliminati

Un conflitto di file modificato eliminato si verifica quando lo stesso file viene modificato in un ramo ma eliminato in un altro. Per ogni file eliminato modificato, decidere con quale azione di ramo si vuole usare. git add <filename> Usare quindi per mantenere il file modificato o git rm <filename> per eliminare il file.

Passaggi successivi

Condividere il codice con modifiche di annullamento push

Articoli correlati

• Novità dei repository Git? Altre informazioni
• Aggiornare il codice con recupero, unione e pull
• Salvare il lavoro con i commit