Użytkownik Gita

Ustawienie nazwy użytkownika oraz adresu e-mail w konfiguracji Gita jest nie tylko dobrym zwyczajem, a wręcz obowiązkowe. Dzięki temu oddane przez Ciebie zmiany będą elegancko nimi opatrzone.

Przykładem może być list zmian:

git log

commit b2696bce91201ba8b90c32717f6d635b64d6a48d
Author: Imię Nazwisko <imie.nazwisko@example.com>
Date:   Mon Jul 14 19:39:32 2025 +0100

    Commit message.

Brak tej konfiguracji zmniejszy czytelność historii zmian w Gicie i może uniemożliwić identyfikację lub kontakt z autorem zmian.

Globalne ustawienia

Git pozwala na ustawienie nazwy użytkownika oraz adresu e-mail globalnie dla wszystkich Twoich projektów w ramach Twojego konta w systemie Windows, Linux lub macOS:

git config -—global user.name "Imię Nazwisko"
git config --global user.email imie.nazwisko@example.com

Zmiany weryfikujemy poleceniem:

git config --list

Ustawienia lokalne dla repozytorium

Git pozwala nadpisać globalne ustawienia dla konkretnego repozytorium:

cd ~/Projects/foo-api
git config user.name "Imię Nazwisko"
git config user.email imie.nazwisko@example.com

Ustawienia dla zbioru repozytoriów

Załóżmy, że chcemy pracować nad swoimi oraz cudzymi projektami na jednym i tym samym koncie Windows, Linux lub macOS:

w katalogu ~/Projects trzymamy swoje projekty
w katalogu ~/Foo trzymamy projekty firmy Foo

Tworzymy plik:

~/Foo/.gitconfig

[core]
    sshCommand = "ssh -i ~/.ssh/id_rsa_foo -F /dev/null"
[user]
    email = imie.nazwisko@foo.com

Zakładamy, że dla każdej firmy przedstawiamy się tak samo, więc modyfikujemy tylko adres e-mail, natomiast imię i nazwisko pozostają bez zmian.

Następnie edytujemy plik konfiguracji Gita i dodajemy do niego:

~/.gitconfig

[includeIf "gitdir:~/Foo/"]
    path = ~/Foo/.gitconfig

Znaki slash / mają znaczenie, więc nie pomiń ich na końcu ścieżki do katalogu. Weryfikujemy najpierw globalne ustawienia:

cd ~
git config user.email

imie.nazwisko@example.com

Weryfikujemy ustawienia dla firmy Foo:

cd ~/Foo/foo-api
git config user.email

imie.nazwisko@foo.com

To działa tylko wtedy, kiedy jesteśmy w kontekście repozytorium Gita. Więc komenda git config user.email wywołana bezpośrednio w katalogu ~/Foo lub w katalogu ~/Foo/not-a-repository wciąż zwróci globalne ustawienia.