n1ro°
RU

Компьютеры · Инструкция

Как проверить .mailmap через git check-mailmap

`.mailmap` помогает сводить старые email и варианты имени одного человека к канонической записи в отчётах Git. `git chec

Редакция N1RO · Проверено

Короткий ответ

Передайте имя и email в `git check-mailmap`: Git вернёт каноническую идентичность согласно `.mailmap`, если для неё есть правило.

Что делать

  1. 1. Добавьте правило: Опишите нужное соответствие в `.mailmap` по синтаксису Git.
  2. 2. Проверьте запись: Передайте исходную идентичность в `git check-mailmap`, например строку вида `Name <old@example.com>`.
  3. 3. Сверьте результат: Если правило сработало, в ответе будет каноническое имя/email.
  4. 4. Проверьте отчёт: После этого запустите `git shortlog -sne`, чтобы увидеть агрегированную историю уже с mailmap.

Пример

После правила `.mailmap` для старого email проверьте его через `git check-mailmap 'Name <old@example.com>'`, затем сравните `shortlog`.

Важно

`.mailmap` не переписывает старые коммиты и их object IDs; она влияет на отображение идентичностей в поддерживающих её командах.

Как понять, что всё сработало

  • `git check-mailmap` возвращает каноническое имя/email для тестовой старой идентичности.
  • После правки `.mailmap` `git shortlog -sne HEAD` больше не дробит одного автора на лишние строки.

Что учитывать

`.mailmap` не переписывает старые коммиты и их object IDs; она влияет на отображение идентичностей в поддерживающих её командах.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. git-check-mailmap Documentation). Пример и формулировки — редакция N1RO на 2026-09-18.