git help

Wyświetla dokumentację i pomoc dla poleceń Git.

git help to twój wbudowany podręcznik do Gita. Zamiast googlować „jak działa git rebase” i trafiać na forum sprzed dekady, wywołujesz dokumentację prosto z terminala — opis polecenia, wszystkie flagi, przykłady i powiązane komendy. Działa identycznie na Linuksie, macOS i Windowsie, bo to część samego Gita. Pod spodem otwiera stronę manuala (man page), tekst w przeglądarce albo zwykły opis — zależnie od opcji i konfiguracji systemu.

Składnia i najważniejsze opcje

Podstawowa forma: git help [opcje] []. Wywołane bez argumentów (git help) pokazuje listę najczęściej używanych poleceń. Najważniejsze flagi:

  • -a, --all — wypisuje wszystkie dostępne polecenia Gita, nie tylko te popularne.
  • -g, --guides — listuje przewodniki koncepcyjne (np. gittutorial, gitworkflows).
  • -c, --config — wypisuje wszystkie nazwy zmiennych konfiguracyjnych dostępnych w plikach config.
  • -m, --man — wymusza wyświetlenie strony manuala (klasyczny format man).
  • -w, --web — otwiera dokumentację w formacie HTML w przeglądarce.
  • -i, --info — pokazuje wersję dokumentacji w formacie info (głównie systemy z GNU info).
  • -v, --verbose — razem z --all dokłada krótki opis do każdego polecenia.

Przykłady użycia

  • git help — wyświetla listę najczęściej używanych poleceń z krótkim opisem. Dobry start, gdy nie pamiętasz nazwy.
  • git help commit — otwiera pełny manual polecenia git commit ze wszystkimi flagami i opcjami.
  • git commit --help — robi dokładnie to samo co wyżej; --help przy dowolnym poleceniu to skrót do git help.
  • git help -a — wyrzuca pełną listę wszystkich poleceń (także porceliny i hydraulika), przydatne do odkrywania nieznanych komend.
  • git help -g — pokazuje przewodniki tematyczne, np. git help gitglossary wyjaśni terminologię.

Częste błędy i pułapki

Najczęstsza pułapka: git help commit domyślnie próbuje otworzyć man page. Na Windowsie (Git Bash) albo w okrojonych kontenerach manuala często brakuje i dostaniesz dokumentację w przeglądarce lub komunikat o błędzie. Wtedy ratuje git commit -h (małe -h!) — pokazuje zwięzłe streszczenie flag bez uruchamiania manuala. Uwaga na różnicę: -h to szybka ściąga, a --help to pełny podręcznik. Zachowanie sterujesz też ustawieniem help.format (man, info lub web) w konfiguracji.

Powiązane komendy: man git, git --version, git config, git -h.