...
Eroare Git · Configurare, comenzi și mediul de lucru

error: unknown switch `M'

Pe scurt

Ai dat unei comenzi Git o opțiune scurtă (o literă după -) pe care nu o are. De obicei e o literă greșită sau o majusculă (-M în loc de -m) ori o opțiune lungă scrisă cu o singură cratimă. Corectează opțiunea; git help comanda îți arată lista.

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

Ce înseamnă

Opțiunile scurte sunt o singură literă după o cratimă (-m, -a, -b), iar cele lungi sunt cuvinte după două cratime (--amend, --hard). Mesajul error: unknown switch M' înseamnă că litera M nu e o opțiune a comenzii pe care ai rulat-o. Git afișează după el usage: git commit [<options>] ...` și lista opțiunilor, iar comanda nu face nimic.

Atenție la majuscule: pentru Git, -m și -M sunt opțiuni diferite (la git branch, -M chiar există și redenumește forțat). Altă cauză frecventă: o opțiune lungă scrisă cu o singură cratimă, de exemplu git reset -hard. Git citește -hard ca pe literele -h -a -r -d, iar în versiunile recente te ajută cu error: did you mean --hard (with two dashes)?. Și opțiunile lungi greșite dau un mesaj asemănător: error: unknown option ammend'`.

De ce apare: cauzele frecvente

1Majusculă în loc de literă mică

Greșit
BASH
git commit -M "Adaug meniul"
Corect
BASH
git commit -m "Adaug meniul"

Opțiunea de mesaj e -m, cu literă mică. -M nu există la git commit.

2Opțiune lungă cu o singură cratimă

Greșit
BASH
git reset -hard HEAD~1
Corect
BASH
git reset --hard HEAD~1

Opțiunile cuvânt au nevoie de două cratime. Cu una singură, Git le citește ca litere separate.

3Opțiune lungă scrisă greșit

Greșit
BASH
git commit --ammend --no-edit
Corect
BASH
git commit --amend --no-edit

Git nu corectează automat opțiunile. Folosește Tab pentru completare.

Repară tu

Repară eroarea, direct în pagină

Ai pus meniu.html în staging și ai tastat git commit -M "Adaug meniul", iar Git răspunde error: unknown switch M' și lista de opțiuni. Fă commit-ul cu mesajul Adaug meniul`.

Indiciu

Uită-te la majusculă.

Alte forme ale mesajului

  • error: did you mean `--hard` (with two dashes)?
  • error: unknown option `ammend'
  • usage: git commit [<options>] [--] <pathspec>...

Cum o eviți pe viitor

  • Folosește completarea cu Tab și pentru opțiuni (scrii --am și apeși Tab).
  • Reține regula: o literă = o cratimă, un cuvânt = două cratime.
  • Când nu ești sigur, git commit -h afișează rapid opțiunile, iar git help commit manualul complet.
  • Citește lista usage afișată după eroare: conține toate opțiunile comenzii.

Întrebări frecvente

Pot combina mai multe opțiuni scurte?

Da: git commit -am "mesaj" e același lucru cu git commit -a -m "mesaj". Opțiunea care primește o valoare (-m) trebuie să fie ultima din grup.

De ce git branch -M merge, dar git commit -M nu?

Opțiunile depind de comandă. La git branch, -M redenumește forțat un branch. La git commit, nu există.

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.