Konfigurowanie i używanie Meld jako git difftool i mergetool

Jak skonfigurować i używać Meld jako git difftool?

Git difftool wyświetla różnice używając programu RÓŻNICUJĄCEGO GUI (np. Meld)zamiast wyświetlania danych wyjściowych różnic w terminalu.

Chociaż można ustawić program GUI w linii poleceń za pomocą -t <tool> / --tool=<tool>, bardziej sensowne jest skonfigurowanie go w pliku .gitconfig. [Uwaga: zobacz sekcje o cudzysłowach specjalnych i ścieżkach okien na dole.]

# Add the following to your .gitconfig file.
[diff]
    tool = meld
[difftool]
    prompt = false
[difftool "meld"]
    cmd = meld "$LOCAL" "$REMOTE"

[Uwaga: ustawienia te nie zmienią zachowania z git diff, który będzie działał jak zwykle.]

Używasz git difftool dokładnie tak samo jak używasz git diff. np.

git difftool <COMMIT_HASH> file_name
git difftool <BRANCH_NAME> file_name
git difftool <COMMIT_HASH_1> <COMMIT_HASH_2> file_name

Jeśli zostanie poprawnie skonfigurowane, otworzy się okno Meld wyświetlające różnice przy użyciu interfejsu GUI.

Kolejność okien interfejsu graficznego Meld może być kontrolowana przez kolejność $LOCAL i $REMOTE w cmd, to znaczy, który plik jest wyświetlany w lewym okienku, a który w prawym. Jeśli chcesz, aby były na odwrót, po prostu wymień je tak:

    cmd = meld "$REMOTE" "$LOCAL"

W końcu linia prompt = false po prostu zatrzymuje git przed pytaniem, czy chcesz uruchomić Meld, czy nie, domyślnie git wystawi monit.

Jak skonfigurować i używać Meld jako git mergetool?

Git mergetool pozwala na użycie programu scalającego GUI (tj. Meld) do rozwiązywania konfliktów scalania, które wystąpiły podczas scalania.

Podobnie jak difftool możesz ustawić program GUI w linii poleceń używając -t <tool> / --tool=<tool> ale, jako wcześniej bardziej sensowne jest skonfigurowanie go w pliku .gitconfig. [Uwaga: zobacz sekcje o cudzysłowach specjalnych i ścieżkach okien na dole.]

# Add the following to your .gitconfig file.
[merge]
    tool = meld
[mergetool "meld"]
    # Choose one of these 2 lines (not both!) explained below.
    cmd = meld "$LOCAL" "$MERGED" "$REMOTE" --output "$MERGED"
    cmd = meld "$LOCAL" "$BASE" "$REMOTE" --output "$MERGED"

Nie używasz git mergetool do wykonania rzeczywistego połączenia. Przed użyciem git mergetool wykonujesz merge w zwykły sposób z Gitem. np.

git checkout master
git merge branch_name

Jeśli występuje konflikt scalania, git wyświetli coś takiego:

$ git merge branch_name
Auto-merging file_name
CONFLICT (content): Merge conflict in file_name
Automatic merge failed; fix conflicts and then commit the result.

W tym momencie file_name będzie zawierać częściowo scalony Plik z informacją o konflikcie scalania (to plik ze wszystkimi wpisami >>>>>>> i <<<<<<<).

Mergetool może być teraz używany do rozwiązywania konfliktów scalania. Zaczynasz bardzo łatwo z:

git mergetool

Jeśli poprawnie skonfigurowane zostanie okno Meld wyświetlające 3 pliki. Każdy plik będzie zawarty w osobnym okienku interfejsu GUI.

W przykładzie .gitconfig powyżej, 2 linie są sugerowane jako [mergetool "meld"] cmd Kolejka W rzeczywistości istnieją różne sposoby dla zaawansowanych użytkowników, aby skonfigurować linię cmd, ale to wykracza poza zakres tej odpowiedzi.

Ta odpowiedź ma 2 alternatywne linie cmd, które między nimi zaspokoją większość użytkowników i będą dobrym punktem wyjścia dla zaawansowanych użytkowników, którzy chcą przenieść narzędzie na wyższy poziom złożoności.

Po pierwsze oto co oznaczają parametry:

• $LOCAL jest plikiem w bieżącej gałęzi (np. master).
• $REMOTE jest plikiem w gałęzi, który jest scalany (np. nazwa gałęzi).
• $MERGED jest częściowo scalonym plikiem z zawartą w nim informacją o konflikcie scalania.
• $BASE jest współdzielonym przodkiem commitów $LOCAL i $REMOTE, to znaczy, że plik jest taki, jaki był, gdy gałąź zawierająca $REMOTE została pierwotnie utworzona.

Proponuję użyć albo:

[mergetool "meld"]
    cmd = meld "$LOCAL" "$MERGED" "$REMOTE" --output "$MERGED"

Lub:

[mergetool "meld"]
    cmd = meld "$LOCAL" "$BASE" "$REMOTE" --output "$MERGED"

Wybór polega na tym, czy użyć $MERGED czy $BASE pomiędzy $LOCAL A $REMOTE.

Tak czy inaczej Meld wyświetli 3 panele z $LOCAL i $REMOTE po lewej i prawa szyba i $MERGED lub $BASE w środkowej szybie.

W obu przypadkach środkowy panel jest plikiem, który należy edytować, aby rozwiązać konflikty scalania. Różnica polega tylko na tym, w której początkowej pozycji edycji wolisz; $MERGED dla pliku, który zawiera częściowo scalony Plik z informacjami o konflikcie scalania lub $BASE dla wspólnego przodka commitów $LOCAL i $REMOTE. [Ponieważ obie linie cmd mogą być przydatne, przechowuję je w moim pliku .gitconfig. Większość czasu używam $MERGED linia i {[36] } linia jest komentowana, ale komentowanie może zostać zamienione, jeśli chcę zamiast tego użyć linii $BASE.]

Po edycji środkowego panelu, aby rozwiązać konflikty scalania, po prostu zapisz plik i zamknij okno Meld. Git wykona aktualizację automatycznie, a plik w bieżącej gałęzi (np. master) będzie teraz zawierał to, co znalazłeś w środkowym okienku.

Git zrobi kopię zapasową częściowo scalonego pliku z merge informacje o konflikcie w nim poprzez dodanie .orig do oryginalnej nazwy pliku. np. file_name.orig. Po sprawdzeniu, czy jesteś zadowolony z połączenia i uruchomieniu jakichkolwiek testów, które chcesz wykonać, plik .orig może zostać usunięty.

W tym momencie możesz wykonać commit, aby zatwierdzić zmiany.

Uwaga: nie martw się, że {[60] } jest używany w cmd niezależnie od tego, czy $MERGED lub $BASE był używany wcześniej w linii cmd. Opcja --output po prostu informuje Meld, jaką nazwę pliku git chce mieć konflikt plik rozdzielczości do zapisania. Meld upewni się, że edycje konfliktu zostaną zapisane w tym pliku niezależnie od tego, czy używasz $MERGED czy $BASE jako początkowego punktu edycji.

Jeśli podczas edycji konfliktów scalania w programie Meld chcesz zrezygnować z użycia programu Meld, zamknij program Meld bez zapisywania pliku rozdzielczości scalania w środkowym okienku. git odpowie Komunikatem file_name seems unchanged, a następnie zapyta Was the merge successful? [y/n], jeśli odpowiesz {[70] } wtedy rozwiązanie konfliktu scalania zostanie przerwane i plik pozostanie niezmieniony. Zauważ, że jeśli w dowolnym momencie zapisałeś plik w Meld, nie otrzymasz ostrzeżenia i monitu od git. [Oczywiście możesz po prostu usunąć plik i zastąpić go plikiem kopii zapasowej .orig stworzonym dla ciebie przez git.]

Jeśli masz więcej niż 1 Plik z konfliktami scalania, git otworzy nowe okno meldowania dla każdego, jeden po drugim, dopóki wszystkie nie zostaną zakończone. Nie wszystkie zostaną otwarte w tym samym czasie, ale po zakończeniu edycji konfliktów w jednym, i zamknij Meld, git otworzy następny, i tak dalej, dopóki wszystkie konflikty scalenia nie zostaną rozwiązane.

Rozsądne byłoby stworzenie atrapy projektu, aby przetestować użycie git mergetool przed użyciem go naNA ŻYWO . Pamiętaj, aby używać nazwy pliku zawierającej spację w teście, na wypadek, gdyby Twój system operacyjny wymagał ucieczki cudzysłowów w linii cmd, patrz poniżej.

Unikanie znaków cytatu

Niektóre systemy operacyjne mogą potrzebować cudzysłowów w cmd uciekł. Mniej doświadczeni użytkownicy powinni pamiętać, że linie komend konfiguracyjnych powinny być testowane z nazwami plików zawierającymi spacje, a jeśli linie cmd nie działają z nazwami plików zawierającymi spacje, spróbuj usunąć cudzysłowy. np.

cmd = meld \"$LOCAL\" \"$REMOTE\"

W niektórych przypadkach może być potrzebna bardziej złożona Ucieczka cytatów. 1. z poniższych linków do ścieżki Windows zawiera przykład potrójnej ucieczki każdego cytatu. To nudne, ale czasami konieczne. np.

cmd = meld \\\"$LOCAL\\\" \\\"$REMOTE\\\"

Okna ścieżki

Użytkownicy systemu Windows będą prawdopodobnie potrzebować dodatkowej konfiguracji dodanej do linii Meld cmd. Może być konieczne użycie pełnej ścieżki do meldc, która jest przeznaczona do wywoływania w systemie Windows z wiersza poleceń, lub może być konieczne lub chcieć użyć wrappera. Powinni przeczytać strony StackOverflow , pod którymi znajdują się linki dotyczące ustawiania właściwej linii Meld cmd dla systemu Windows. Ponieważ jestem użytkownikiem Linuksa, nie jestem w stanie przetestować różnych linii Windows cmd i nie mam więcej informacje na ten temat inne niż zalecane użycie moich przykładów z dodaniem pełnej ścieżki do Meld lub meldc, lub dodanie folderu programu Meld do path.

• Git Diff and Meld on Windows
• Jak ustawić Meld jako git mergetool
• Git mergetool z Meld na Windows

Ignorowanie ciągłych białych spacji za pomocą Meld

Meld ma wiele preferencji, które można skonfigurować w GUI.

W zakładce Preferencje Text Filters Znajduje się kilka przydatnych filtrów do ignorowania komentarzy podczas wykonywania różnic. Chociaż istnieją filtry do ignorowania All whitespace i Leading whitespace, nie ma filtra ignorowania Trailing whitespace (został on zasugerowany jako dodatek na liście dyskusyjnej Meld, ale nie jest dostępny w mojej wersji).

Ignorowanie końcowych spacji jest często bardzo przydatne, szczególnie podczas współpracy. można je łatwo dodać ręcznie za pomocą prostego wyrażenia regularnego w Meld preferences Text Filters tab.

# Use either of these regexes depending on how comprehensive you want it to be.
[ \t]*$
[ \t\r\f\v]*$