Пошаговая настройка Git на macOS: установка и конфигурация

Введение / Зачем это нужно

Система контроля версий Git — базовый инструмент для любого разработчика, DevOps-инженера или технического писателя, работающего с документацией. На macOS Git часто требуется для взаимодействия с GitHub, GitLab или внутренними репозиториями компании.

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

Требования / Подготовка

Перед началом убедитесь, что у вас есть:

• Компьютер с macOS 12 Monterey или более новой версией.
• Доступ к терминалу (приложение Терминал в папке Программы/Утилиты или сторонний эмулятор вроде iTerm2).
• Права администратора (понадобятся для установки системных пакетов).
• Стабильное подключение к интернету.

💡 Совет: Если у вас уже установлен пакетный менеджер Homebrew, процесс займёт не больше минуты. Если нет — мы рассмотрим установку через стандартные средства Apple.

Пошаговая инструкция

Шаг 1: Установка Git на macOS

Существует два основных способа поставить Git на мак: через Xcode Command Line Tools (встроенные утилиты Apple) или через пакетный менеджер Homebrew (рекомендуется для получения самой свежей версии).

Способ 1: Через Xcode Command Line Tools Откройте терминал и выполните команду:

xcode-select --install

В появившемся системном окне нажмите «Установить». Этот пакет содержит не только Git, но и компиляторы clang, make и другие инструменты разработчика.

Способ 2: Через Homebrew (актуальная версия) Если Homebrew ещё не установлен, сначала запустите официальный скрипт установки, а затем сам Git:

# Установка Homebrew (если менеджер отсутствует)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Установка Git через Homebrew
brew install git

Шаг 2: Проверка успешной установки

После завершения установки проверьте, что система видит исполняемый файл и определяет его версию:

git --version

Вывод должен выглядеть примерно так: git version 2.45.1 (цифры могут отличаться в зависимости от даты). Если терминал выдаёт command not found: git, перезапустите терминал или проверьте переменную окружения $PATH.

Шаг 3: Базовая настройка профиля пользователя

Git не позволит сделать коммит, пока вы не укажете своё имя и email. Эти данные будут «штамповаться» на каждом вашем изменении кода, чтобы другие участники команды понимали, кто внёс правку.

Выполните две команды, подставив свои реальные данные:

git config --global user.name "Ivan Petrov"
git config --global user.email "ivan@example.com"

Флаг --global означает, что настройки применятся ко всем репозиториям на этом компьютере. Если нужно задать отдельные данные для конкретного проекта, запускайте те же команды без --global внутри папки проекта.

Шаг 4: Дополнительная конфигурация

Чтобы работа была комфортнее, рекомендуем сразу задать текстовый редактор по умолчанию (для написания сообщений коммитов) и название основной ветки.

# Установка редактора (например, Visual Studio Code)
git config --global core.editor "code --wait"

# Задание имени ветки по умолчанию (современный стандарт — main)
git config --global init.defaultBranch main

⚠️ Важно: Если вы используете редактор, отличный от VS Code (например, Nano или Vim), убедитесь, что он установлен в системе, иначе Git будет выдавать ошибку при попытке создать коммит.

Проверка результата

Чтобы убедиться, что всё настроено верно, выведите список всех активных конфигураций:

git config --list

В терминале вы должны увидеть строки user.name, user.email, core.editor и init.defaultbranch с вашими значениями.

Для финальной проверки создайте тестовый репозиторий:

mkdir test-repo && cd test-repo
git init
git commit --allow-empty -m "Тестовый коммит"

Если команда git commit отработала без ошибок и вывела хеш коммита, поздравляем — ваш Git полностью готов к работе! Папку test-repo можно удалить.

Возможные проблемы

Ошибка xcrun: error: invalid active developer path Возникает, если вы обновили macOS, а Xcode Command Line Tools «слетели». Исправляется переустановкой:

sudo xcode-select --reset
xcode-select --install

Git использует старую версию после установки через Homebrew На некоторых системах приоритет отдаётся встроенной версии Apple. Проверьте путь: which git. Если он указывает на /usr/bin/git, добавьте путь Homebrew (/opt/homebrew/bin или /usr/local/bin) в начало переменной $PATH в файле ~/.zshrc.

Ошибка доступа Permission denied (publickey) при клонировании Эта проблема возникает не на этапе настройки Git, а при работе с удалёнными серверами (GitHub). Вам потребуется сгенерировать SSH-ключ и добавить его в аккаунт на хостинге репозиториев.