...
Eroare Git · Pull, rebase și branch-uri divergente

Please enter a commit message to explain why this merge is necessary

Pe scurt

Nu e o eroare: git pull sau git merge a creat un commit de merge și a deschis editorul (adesea Vim) ca să confirmi mesajul. În Vim, apasă Esc, scrie :wq și Enter; Git păstrează mesajul propus și termină merge-ul.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Când branch-ul tău și cel de pe server au amândouă commit-uri noi, git pull (în modul merge) le unește printr-un commit de merge. Ca la orice commit, Git îți cere un mesaj și deschide editorul configurat, cu mesajul propus deja scris: Merge branch 'main' of https://github.com/.... Liniile care încep cu #, printre care și Please enter a commit message to explain why this merge is necessary, sunt doar instrucțiuni și nu intră în mesaj.

Pe Linux și macOS, editorul implicit e de obicei Vim, unde tastele nu se comportă ca într-un editor obișnuit. Ca să accepți mesajul: Esc, apoi :wq și Enter. Ca să anulezi merge-ul: Esc, :cq și Enter. Pe viitor, poți evita editorul cu git pull --no-edit sau poți seta un editor mai simplu (git config --global core.editor nano).

De ce apare: cauzele frecvente

1git pull cu branch-uri divergente, în modul merge

Greșit
BASH
git pull --no-rebase
# se deschide Vim și nu știi cum ieși
Corect
BASH
git pull --no-rebase --no-edit

--no-edit acceptă direct mesajul propus, fără să mai deschidă editorul.

2git merge fără -m

Greșit
BASH
git merge --no-ff feature/cos
Corect
BASH
git merge --no-ff feature/cos -m "Merge feature/cos"

Cu -m, mesajul e dat în comandă, deci editorul nu se mai deschide.

3Editorul implicit e Vim

Greșit
BASH
git pull
Corect
BASH
git config --global core.editor nano
git pull

Cu nano (sau code --wait pentru VS Code), salvezi și închizi cu comenzi pe care le vezi pe ecran.

Repară tu

Repară eroarea, direct în pagină

Tu ai commit-ul Pagina Contact, iar colegul a urcat Pagina Despre. La git pull, Git a deschis Vim cu Please enter a commit message to explain why this merge is necessary și ai închis terminalul. Adu commit-ul colegului printr-un merge cu mesajul implicit, fără să se deschidă editorul, apoi urcă rezultatul.

Indiciu

Pull-ul poate primi o opțiune care acceptă direct mesajul propus.

Alte forme ale mesajului

  • # Please enter a commit message to explain why this merge is necessary, # especially if it merges an updated upstream into a topic branch.
  • Merge branch 'main' of https://github.com/elev/blog
  • # Lines starting with '#' will be ignored, and an empty message aborts # the commit.

Cum o eviți pe viitor

  • Setează un editor pe care îl știi: git config --global core.editor "code --wait" sau nano.
  • Pentru pull-uri, alege o strategie: git config --global pull.rebase true evită commit-urile de merge la pull.
  • Când vrei mesajul implicit, folosește --no-edit.

Întrebări frecvente

Am închis terminalul cu editorul deschis. Ce fac?

Merge-ul a rămas neterminat. Rulează git status: dacă vezi All conflicts fixed but you are still merging, termină cu git commit --no-edit. Dacă Git se plânge de un fișier .swp, șterge-l sau alege opțiunea de recuperare din Vim.

Trebuie să schimb mesajul?

Nu e obligatoriu. Mesajul propus spune deja ce s-a unit. Îl poți completa dacă merge-ul are o explicație utilă pentru echipă.

Erori înrudite

← Toate erorile Git

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Git de la zero, cu exerciții la fiecare lecție

Curs Git: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.