Визуализация топологии ветки в Git

Я играю с Git изолированно на своей собственной машине, и мне трудно поддерживать ментальную модель всех моих ветвей и коммитов. Я знаю, что могу сделать, git logчтобы увидеть историю коммитов, откуда я нахожусь, но есть ли способ увидеть всю топографию ветви, что-то вроде этих карт ASCII, которые, кажется, используются повсеместно для объяснения ветвей?

      .-A---M---N---O---P
     /     /   /   /   /
    I     B   C   D   E
     \   /   /   /   /
      `-------------'

Такое ощущение, что кто-то придет и попытается забрать мой репозиторий, будет трудно точно понять, что происходит.

Я думаю, что на меня влияет потоковый браузер AccuRev ...

Используйте git log --graphили gitk. (Оба также принимают --all, что покажет все ветви вместо только текущей.)

Для названий ветвей и компактного вида попробуйте:

git log --graph --decorate --oneline

Я обычно использую

git log --graph --full-history --all --pretty=format:"%h%x09%d%x20%s"

С цветами (если ваша оболочка Bash):

git log --graph --full-history --all --color \
        --pretty=format:"%x1b[31m%h%x09%x1b[32m%d%x1b[0m%x20%s"

Это напечатает текстовое представление следующим образом:

* 040cc7c       (HEAD, master) Manual is NOT built by default
* a29ceb7       Removed offensive binary file that was compiled on my machine and was hence incompatible with other machines.
| * 901c7dd     (cvc3) cvc3 now configured before building
| * d9e8b5e     More sane Yices SMT solver caller
| | * 5b98a10   (nullvars) All uninitialized variables get zero inits
| |/
| * 1cad874     CFLAGS for cvc3 to work successfully
| *   1579581   Merge branch 'llvm-inv' into cvc3
| |\
| | * a9a246b   nostaticalias option
| | * 73b91cc   Comment about aliases.
| | * 001b20a   Prints number of iteration and node.
| |/
|/|
| * 39d2638     Included header files to cvc3 sources
| * 266023b     Added cvc3 to blast infrastructure.
| * ac9eb10     Initial sources of cvc3-1.5
|/
* d642f88       Option -aliasstat, by default stats are suppressed

(Вы можете просто использовать git log --format=oneline, но он свяжет сообщения коммитов с числами, что выглядит ИМХО менее привлекательно).

Чтобы сделать ярлык для этой команды, вы можете отредактировать ваш ~/.gitconfigфайл:

[alias]
  gr = log --graph --full-history --all --color --pretty=tformat:"%x1b[31m%h%x09%x1b[32m%d%x1b[0m%x20%s%x20%x1b[33m(%an)%x1b[0m"

Однако, как замечает Содел Лобовое в комментариях, такую ​​длинную команду форматирования трудно запомнить. Обычно это не проблема, так как вы можете поместить это в ~/.gitconfigфайл. Однако, если вам иногда приходится входить на удаленную машину, где вы не можете изменить файл конфигурации, вы можете использовать более простую, но более быструю версию:

git log --graph --oneline

У меня есть 3 псевдонима (и 4 псевдонима для быстрого использования), которые я обычно добавляю в свой ~/.gitconfigфайл:

[alias]
    lg = lg1
    lg1 = lg1-specific --all
    lg2 = lg2-specific --all
    lg3 = lg3-specific --all

    lg1-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(auto)%d%C(reset)'
    lg2-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset)%C(auto)%d%C(reset)%n''          %C(white)%s%C(reset) %C(dim white)- %an%C(reset)'
    lg3-specific = log --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold cyan)%aD%C(reset) %C(bold green)(%ar)%C(reset) %C(bold cyan)(committed: %cD)%C(reset) %C(auto)%d%C(reset)%n''          %C(white)%s%C(reset)%n''          %C(dim white)- %an <%ae> %C(reset) %C(dim white)(committer: %cn <%ce>)%C(reset)'

git lg/ git lg1выглядит так:

git lg2 выглядит так:

и git lg3выглядит так:

Следует отметить, что это не означает, что это решение для всех, это шаблон, который вы можете изменить, дополнить и исправить по своему вкусу. Если вы хотите использовать их, я рекомендую:

1. Добавьте их в свой .gitconfig,
2. Настройте по своему вкусу (разные цветовые решения, разное расположение линий для двух- и трехстрочных версий и т. Д.),
3. А затем сохраните копию в Gist или другом инструменте фрагмента кода, чтобы вы могли скопировать и вставить его в .gitconfigs в будущем (или, конечно, в качестве альтернативного варианта управления вашими точечными файлами) .

_{Примечание. Ответ скопирован и улучшен в ответе на stackoverflow.com/questions/1057564/pretty-git-branch-graphs, поскольку он гораздо более уместен здесь, чем был там. Оставьте копию другого вопроса по историческим причинам - сейчас он закрыт, а на ответ ссылается куча других ответов.}

К любому из этих рецептов (на основе git log или gitk) вы можете добавить, --simplify-by-decorationчтобы свернуть неинтересные линейные части истории. Это делает намного больше видимой топологии сразу. Теперь я могу понять большие истории, которые были бы непостижимы без этой опции!

Я чувствовал необходимость опубликовать это, потому что это не так хорошо известно, как должно быть. Его нет в большинстве вопросов о переполнении стека, касающихся визуализации истории, и мне потребовалось немало времени, чтобы найти его - даже после того, как я понял, что хочу этого! Я наконец нашел это в отчете об ошибках Debian . Первое упоминание о переполнении стека, по-видимому, было ответом Антуана Пелисса.

Gitk Иногда мне больно читать.

Мотивировать меня, чтобы написать GitVersionTree .

99,999% моего времени смотрят на историю, git lgа 0,001% - на git log.

Я просто хочу поделиться двумя псевдонимами журнала, которые могут быть полезны (настроить из .gitconfig):

[Alias]
     lg = log --graph --pretty=format:'%Cred%h%Creset %ad %s %C(yellow)%d%Creset %C(bold blue)<%an>%Creset' --date=short
     hist = log --graph --full-history --all --pretty=format:'%Cred%h%Creset %ad %s %C(yellow)%d%Creset %C(bold blue)<%an>%Creset' --date=short

• git lg увидим текущую ветку истории.
• git hist увидим всю ветку истории.

Взгляните на Gitkraken - кроссплатформенный графический интерфейс, который четко показывает топологию.

Вот краткий видеоурок о некоторых дополнительных функциях.

Мне нравится git logделать с:

 git log --graph --oneline --branches

(также с --all, для просмотра удаленных веток)

Работает с последними выпусками Git: выпущено с 1.6.3 ( четверг, 7 мая 2009 г. )

• --pretty=<style>Параметр « » для семейства команд журнала теперь можно записать как « --format=<style>».
  Кроме того, --format=%formatstringэто сокращение для --pretty=tformat:%formatstring.

• " --oneline" является синонимом " --pretty=oneline --abbrev-commit".

PS D:\git\tests\finalRepo> git log --graph --oneline --branches --all
* 4919b68 a second bug10 fix
* 3469e13 a first bug10 fix
* dbcc7aa a first legacy evolution
| * 55aac85 another main evol
| | * 47e6ee1 a second bug10 fix
| | * 8183707 a first bug10 fix
| |/
| * e727105 a second evol for 2.0
| * 473d44e a main evol
|/
* b68c1f5 first evol, for making 1.0

Вы также можете ограничить интервал отображения журнала (количество коммитов):

PS D:\git\tests\finalRepo> git log --graph --oneline --branches --all -5
* 4919b68 a second bug10 fix
* 3469e13 a first bug10 fix
* dbcc7aa a first legacy evolution
| * 55aac85 another main evol
| | * 47e6ee1 a second bug10 fix

(показать только последние 5 коммитов)

Что мне не нравится в текущем выбранном решении:

 git log --graph

Он отображал слишком много информации (когда я хочу только посмотреть на краткое резюме):

PS D:\git\tests\finalRepo> git log --graph
* commit 4919b681db93df82ead7ba6190eca6a49a9d82e7
| Author: VonC <vonc@laposte.net>
| Date:   Sat Nov 14 13:42:20 2009 +0100
|
|     a second bug10 fix
|
* commit 3469e13f8d0fadeac5fcb6f388aca69497fd08a9
| Author: VonC <vonc@laposte.net>
| Date:   Sat Nov 14 13:41:50 2009 +0100
|
|     a first bug10 fix
|

gitk отлично, но вынуждает меня покинуть сессию оболочки для другого окна, тогда как отображение последних n коммитов достаточно часто.

Gitg - отличный инструмент для Linux, похожий на Gitx для OS X. Просто запустите «gitg» в командной строке где-то внутри древовидной структуры вашего хранилища (то же самое с gitx).

Я нашел "git-big-picture" довольно полезным: https://github.com/esc/git-big-picture

Он создает симпатичные 2D-графики, используя точку / график вместо довольно линейных, «одномерных» представлений, которые производят gitk и друзья. С опцией -i он показывает точки ветвления и коммиты слияния, но пропускает все промежуточное.

Хороший веб-инструмент - неопрятный . Он работает на любой платформе, которую поддерживает node.js & git. Есть видео о том, как это работает для тех, кому такие вещи легче читать, чем читать ...

Посмотрите на BranchMaster .

Я написал это, чтобы визуализировать сложную структуру веток, сворачивая все коммиты между ними в одну строку. Цифры указывают количество коммитов.

Никто не упомянул tig ? Это не сворачивает ветви как "BranchMaster", но ...

Это быстро, работает в терминале.

Поскольку это так быстро (+ управление с клавиатуры), вы получаете отличный UX, это почти как мое " ls" для каталогов, содержащих git-репозитории.

https://jonas.github.io/tig/

Имеются обычные ярлыки, /для поиска и т. Д.

(ps. это терминал на фоне этого скриншота, сейчас он выглядит лучше, но мой компьютер отказывается делать скриншот, извините)

(pps. Я тоже использую gitkraken и у меня действительно четкие визуализации, но он намного тяжелее tig)

У Tortoise Git есть инструмент под названием «График ревизий». Если вы работаете в Windows, это так же просто, как щелкнуть правой кнопкой мыши по вашему репозиторию -> Tortoise Git -> Revision Graph.

Хихикает рисует действительно хорошие графики.

Я использую следующие псевдонимы.

[alias]
    lol = log --graph --decorate --pretty=oneline --abbrev-commit
    lola = log --graph --decorate --pretty=oneline --abbrev-commit --all

Он содержит больше информации в цветовой схеме, чем псевдонимы, которые я видел выше. Это также кажется довольно распространенным явлением, поэтому у вас может быть шанс, что он будет существовать в окружении другого человека или упомянуть об этом в разговоре без объяснения причин.

Со скриншотами и полным описанием здесь: http://blog.kfish.org/2010/04/git-lola.html

Для пользователей Mac: закажите (не каламбур) бесплатный инструмент с открытым исходным кодом GitUp: http://gitup.co/

Мне нравится способ отображения графиков, он понятнее, чем некоторые другие инструменты, которые я видел.

Проект находится здесь: https://github.com/git-up/GitUp

У меня есть этот git logпсевдоним ~/.gitconfigдля просмотра истории графа:

[alias]
l = log --all --graph --pretty=format:'%C(auto)%h%C(auto)%d %s %C(dim white)(%aN, %ar)'

С псевдонимом на месте, git lпокажет что-то вроде этого:

В Git 2.12 + вы даже можете настроить цвета линий графика, используяlog.graphColors опцию конфигурации.

Что касается формата логов, то он похож --onelineна добавление имени автора (с уважением .mailmap) и относительной даты автора . Обратите внимание, что %C(auto)синтаксис, который говорит Git использовать цвета по умолчанию для хэша коммита и т. Д., Поддерживается в Git> = 1.8.3 .

Я нашел это сообщение в блоге, которое показывает краткий путь:

git log --oneline --abbrev-commit --all --graph --decorate --color

Я обычно создаю псевдоним для вышеуказанной команды:

alias gl='git log --oneline --abbrev-commit --all --graph --decorate --color'

и просто просто использовать gl .

Вы также можете добавить псевдоним в конфигурацию git. Откройте ~/.gitconfigи добавьте следующую строку в [псевдоним]

[alias]
        lg = log --oneline --abbrev-commit --all --graph --decorate --color

и используйте это так: git lg

Мой личный любимый псевдоним через .gitconfig:

graph = log --graph --color --all --pretty=format:"%C(yellow)%H%C(green)%d%C(reset)%n%x20%cd%n%x20%cn%x20(%ce)%n%x20%s%n"

Для тех, кто использует текстовый редактор VSCode , рассмотрим расширение Git History от D. Jayamanne:

Gitx также фантастический инструмент визуализации, если вы оказались на OS X.

Еще одна команда git log. Этот с фиксированной шириной столбцов :

git log --graph --pretty=format:"%x09%h | %<(10,trunc)%cd |%<(25,trunc)%d | %s" --date=short

Проверьте SmartGit. Это очень напоминает мне визуализацию ветки TortoiseHg, и это бесплатно для некоммерческого использования.

В Windows есть очень полезный инструмент, который вы можете использовать: расширения git. Это графический инструмент, который делает операции с Git очень простыми.

Также это с открытым исходным кодом.

http://gitextensions.github.io

Я пробовал, --simplify-by-decorationно все мои слияния не отображаются. Поэтому я вместо этого просто обрезаю строки без символов «\» и «/» в заголовках, сохраняя при этом строки со знаком «(», указывающим ветви сразу после этого. При отображении истории ветвей я вообще не заинтересован в комментариях к коммитам, поэтому Я тоже их удаляю и получаю следующий псевдоним оболочки.

gbh () { 
    git log --graph --oneline --decorate "$@" | grep '^[^0-9a-f]*[\\/][^0-9a-f]*\( [0-9a-f]\|$\)\|^[^0-9a-f]*[0-9a-f]*\ (' | sed -e 's/).*/)/'
}

мы можем сделать это более сложным?

Как насчет простого журнала git --all --decorate --oneline --graph (помните A Dog = --All --Украсить --Oneine --Graph)

Официальный сайт Git привлек некоторые сторонние инструменты графического интерфейса платформы. Нажмите здесь Инструменты git GUI для платформы Linux

Я использовал gitgи GitKrakenдля платформы Linux. Оба хорошо, чтобы понять дерево коммитов

Самые рейтинговые ответы, показывающие git log команды как любимые решения.

Если вам нужен табличный , скажем, реальный столбец, такой как вывод, вы можете использовать свои классные команды git log с небольшими изменениями и некоторыми ограничениями с помощью .gitconfig alias.bly фрагмента ниже.

Модификации:

• ты должен использовать %><(<N>[,ltrunc|mtrunc|trunc]) перед каждым коммитом фиксации
• добавить уникальный разделитель в качестве разделителя столбцов
• добавить --colorопцию для цветного вывода

Ограничения:

• если график не должен быть помещен в первый столбец, вы не можете добавить другие символы для украшения, как (committer:, <и >)как в

  ...%C(dim white)(committer: %<(15,trunc)%cn%<(25,trunc)<%ce>)%C(reset)...

  чтобы получить табличный вывод

Пример взят с этого сайта:

thompson1     = log --all --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(auto)%d%C(reset)'

будет с ^разделителем и без добавленных символов

thompson1-new = log --all --graph --color --abbrev-commit --decorate --format=format:'^%C(bold blue)%<(7,trunc)%h%C(reset)^%C(bold green)%<(21,trunc)%ar%C(reset)^%C(white)%<(40,trunc)%s%C(reset)^%C(dim white)%<(25,trunc)%an%C(reset)^%C(auto)%d%C(reset)'

который сравнивает как

или с перемещением графика в столбец 5

Для этого добавьте следующее в ваш .gitconfig и назовите псевдоним журнала с помощью git tably YourLogAlias

[color "decorate"]
    HEAD = bold blink italic 196
    branch = 214
    tag = bold 222

[alias]

    # delimiter used as column seperator
    delim = ^
    # example thompson1
    thompson1     = log --all --graph --abbrev-commit --decorate --format=format:'%C(bold blue)%h%C(reset) - %C(bold green)(%ar)%C(reset) %C(white)%s%C(reset) %C(dim white)- %an%C(reset)%C(auto)%d%C(reset)'
    # modified thompson1 example
    thompson1-new = log --all --graph --color --abbrev-commit --decorate --format=format:'^%C(bold blue)%<(7,trunc)%h%C(reset)^%C(bold green)%<(21,trunc)%ar%C(reset)^%C(white)%<(40,trunc)%s%C(reset)^%C(dim white)%<(25,trunc)%an%C(reset)^%C(auto)%d%C(reset)'
    # set a column for the graph
    thompson1-new-col = 1

    tably = !bash -c '"                                                                                                            \
              delim=$(git config alias.delim);                                                                                     \
              git_log_cmd=$(git config alias.$1);                                                                                  \
              git_tre_col=${2:-$(git config alias.$1-col)};                                                                        \
                                                                                                                                   \
              i=0;                                                                                                                 \
              while read -d\"$delim\" -r col_info;do                                                                               \
                ((i++));                                                                                                           \                   
                col_length[$i]=$(grep -Eo \"\\([0-9]*,[lm]*trunc\\)\" <<< \"$col_info\" | grep -Eo \"[0-9]*\" | head -n 1);        \
              done <<< \"$(grep -Eo \"(pretty|format)=format.*\" <<< \"$git_log_cmd$delim\")\";                                    \
                                                                                                                                   \
              while IFS= read -r graph;do                                                                                          \
                chars_count=$(sed -nl1000 \"l\" <<< \"$graph\" | grep -Eo \"\\\\\\\\\\\\\\\\|\\||\\/|\\ |\\*|_\" | wc -l);         \
                [[ ${chars_count:-0} -gt ${col_length[1]:-0} ]] && col_length[1]=$chars_count;                                     \
              done < <([[ -n \"$(grep -F graph <<< \"$git_log_cmd\")\" ]] && git log --all --graph --pretty=format:\" \" && echo); \
                                                                                                                                   \
              while IFS= read -r line;do                                                                                           \
                j=0;                                                                                                               \
                while IFS= read -d\"$delim\" -r col_content;do                                                                     \
                  ((j++));                                                                                                         \
                  if [[ $j -eq 1 ]];then                                                                                           \
                    chars=$(sed -nl1000 \"l\" <<< \"$col_content\" | grep -Eo \"\\\\\\\\\\\\\\\\|\\||\\/|\\ |\\*|_\" | wc -l);     \
                    whitespaces=$((${col_length[1]}-$chars));                                                                      \
                    whitespaces=$(seq -s\" \" $whitespaces|tr -d \"[:digit:]\");                                                   \
                    col_content[1]=\"${col_content[1]}$col_content$whitespaces\n\";                                                \
                  else                                                                                                             \
                    col_content[$j]=\"${col_content[$j]}$(printf \"%${col_length[$j]}s\" \"$col_content\") \n\";                   \
                  fi;                                                                                                              \
                done <<< \"$line$delim\";                                                                                          \
                for ((k=$j+1;k<=$i;k++));do                                                                                        \
                  col_content[$k]=\"${col_content[$k]}$(printf \"%${col_length[$k]}s\" \"\") \n\";                                 \
                done;                                                                                                              \
              done < <(git $1 && echo);                                                                                            \
                                                                                                                                   \
              while read col_num;do                                                                                                \
                if [[ -z \"$cont_all\" ]];then                                                                                     \
                  cont_all=${col_content[$col_num]};                                                                               \
                else                                                                                                               \
                  cont_all=$(paste -d\" \" <(echo -e \"$cont_all\") <(echo -e \"${col_content[$col_num]}\"));                      \
                fi;                                                                                                                \
              done <<< $(seq 2 1 ${git_tre_col:-1};seq 1;seq $((${git_tre_col:-1}+1)) 1 $i);                                       \
              echo -e \"$cont_all\";                                                                                               \
            "' "git-tably"

Это более или менее только часть моего ответа https://stackoverflow.com/a/61487052/8006273, где вы можете найти более глубокие объяснения, но здесь тоже хорошо подходит этот вопрос.