Git

Git в заголовке панели#

Когда панель находится внутри репозитория, её заголовок показывает текущую ветку, на сколько коммитов она опережает (↑) и отстаёт (↓) и сколько файлов изменено. Рядом:

Название ветки

Открывает список веток: сначала локальные, затем существующие только на удалённом репозитории. Щёлкните по ветке (или нажмите Enter), чтобы переключиться. Введите несуществующее имя и нажмите Enter, чтобы создать ветку и переключиться на неё. Ветки, извлечённые в другом worktree, помечены и недоступны для выбора.

Diff

Открывает незакоммиченные изменения папки этой панели, не открывая окно Git.

Worktree

Создаёт worktree для этого репозитория. См. Worktree.

Commit

Открывает состояние файлов в окне Git с фокусом на поле сообщения.

Fetch / Pull / Push

Pull подсвечивается, когда есть что получать. Без upstream получение идёт из ветки по умолчанию удалённого репозитория (например, origin/main); источник указан во всплывающей подсказке. Push появляется, когда есть неотправленные коммиты.

Окно Git#

Нажмите Git на панели инструментов или Cmd/Ctrl+E, чтобы открыть окно Git для репозитория терминала в фокусе. Значок на панели инструментов показывает число изменённых файлов. Закрыть окно можно клавишей Esc, кнопкой × или повторным Cmd/Ctrl+E. Перетаскивайте края, чтобы изменить размер; двойной щелчок по маркеру возвращает исходный.

Слева можно переключаться между разделами Состояние файлов, История, Поиск, worktree, issues и pull request’ами; там же перечислены Ветки (сгруппированные в папки по /), Удалённые и Теги. Щёлкните по ссылке, чтобы показать её коммит в истории; дважды щёлкните по ветке, чтобы переключиться на неё.

Просмотр и коммит изменений#

1. Откройте окно Git. Оно открывается на разделе Состояние файлов со списком всех незакоммиченных файлов, их статусом и числом строк.
2. Щёлкните по файлу, чтобы увидеть diff с номерами строк. Снимите флажки с файлов, которые не должны попасть в этот коммит.
3. Напишите сообщение в поле Сообщение коммита. Отметьте Сделать push после коммита, чтобы сразу отправить изменения.
4. Нажмите Commit или Cmd/Ctrl+Enter.

Все изменения открывает diff всей рабочей копии в просмотрщике побольше. Длинные строки там переносятся, а край списка файлов можно перетащить, чтобы расширить его.

Просмотр истории#

История рисует граф коммитов по всем локальным и удалённым веткам и тегам. Выберите коммит, чтобы увидеть ниже его файлы и патч. Поиск фильтрует по сообщению, автору или хешу.

Правый щелчок по коммиту → Откатиться к этому коммиту... сбрасывает ветку на него. Более поздние коммиты выпадают из текущей истории, а незакоммиченные изменения в отслеживаемых файлах отбрасываются (неотслеживаемые файлы остаются), поэтому сначала запрашивается подтверждение.

Pull, push, fetch и stash#

Pull

Выберите, какую удалённую ветку подтянуть в текущую, не переключая ветки.

Push

Отправляет текущую ветку и при первой отправке задаёт её upstream.

Fetch

Получает обновления со всех удалённых репозиториев.

Stash

Откладывает изменения, включая неотслеживаемые файлы (git stash push -u).

Когда Git не может работать#

Если что-то на вашем компьютере мешает работе git, PATerminal объяснит причину и покажет исправление в одну строку — с кнопками Ввести в терминал (Enter нажимаете вы) и Копировать. Распознаются непринятая лицензия Xcode, отсутствующие Command Line Tools, неустановленный Git, папка, принадлежащая другому пользователю («dubious ownership»), и ограничение длины пути в Windows.