Введение / Зачем это нужно
Git — это незаменимый инструмент для контроля версий кода, сотрудничества в проектах и ведения истории изменений. На macOS базовая установка часто отсутствует, поэтому новичкам требуется несколько минут, чтобы настроить Git и начать работу. После выполнения этого руководства вы сможете создавать репозитории, делать коммиты и работать с удалёнными репозиториями через SSH.
Требования / Подготовка
- macOS версии 10.15 Catalina или новее (например, Ventura, Monterey, Big Sur).
- Доступ в интернет для установки Homebrew или загрузки установщика.
- Терминал (приложение Terminal).
- Права администратора, если используется Homebrew (
brew install).
Шаг 1: Установите Git
Лучший способ — использовать Homebrew, который также упрощает последующие обновления.
# Установите Git через Homebrew (если он еще не установлен)
brew install git
Если вы предпочитаете официальный установщик, скачайте его с https://git-scm.com/download/mac и следуйте инструкциям мастера.
Шаг 2: Проверьте установку и настройте пользователя
Проверьте, что команда Git доступна в терминале.
git --version
Настройте глобальные параметры пользователя — они будут использоваться во всех ваших репозиториях.
git config --global user.name "Ваше Имя"
git config --global user.email "your_email@example.com"
Шаг 3: Настройте SSH-ключ для безопасного доступа
SSH-ключи обеспечивают защищённый и удобный доступ к удалённым репозиториям.
# Сгенерируйте ключ типа ed25519 (современный и быстрый алгоритм)
ssh-keygen -t ed25519 -C "your_email@example.com"
# Скопируйте публичный ключ в буфер обмена macOS
pbcopy < ~/.ssh/id_ed25519.pub
Теперь добавьте приватный ключ в агент SSH — он будет автоматически подставляться при подключении.
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
Публичный ключ (скопированный выше) добавьте на серверы GitHub, GitLab или Bitbucket, где вы будете хранить код.
Шаг 4: Создайте первый репозиторий и сделайте коммит
Создайте временную папку, инициализируйте репозиторий и сделайте первый коммит.
mkdir my-project && cd my-project
git init
echo "# My Project" > README.md
git add .
git commit -m "Initial commit"
Теперь у вас есть локальный репозиторий с историей. Вы можете добавить удалённый и отправить изменения:
git remote add origin https://github.com/yourusername/my-project.git
git push -u origin main
Проверка результата
Чтобы убедиться, что всё работает:
- В терминале перейдите в каталог
my-project. - Выполните
git log --oneline— должна отобразиться запись «Initial commit». - Проверьте
git remote -v— отображается URL origin. - На GitHub (или другом хостинге) проверьте, что репозиторий отображается.
Если вы можете выполнить git pull и git push без запроса пароля, SSH настроено верно.
Возможные проблемы
Команда git не найдена
⚠️ Важно: Проверьте, что Git добавлен в ваш
PATH. Обычно это/usr/local/bin(Homebrew) или/opt/homebrew/bin(Apple Silicon).
Решение: добавьте путь в файл ~/.zshrc (или ~/.bash_profile):
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
brew reinstall git
Ошибки прав доступа при коммитах
💡 Совет: Если вы видите «permission denied», убедитесь, что у вас есть права на запись в каталог репозитория.
Решение: перейдите в корневую папку проекта (cd ~) и убедитесь, что у вас есть права на запись:
chmod -R 755 my-project
SSH-ключ не авторизован
⚠️ Важно: Убедитесь, что публичный ключ добавлен на хостинге, и что ключ загружен в ssh-agent.
Решение: проверьте агент и список ключей:
ssh-agent -s
ssh-add ~/.ssh/id_ed25519
cat ~/.ssh/id_ed25519.pub
Скопируйте вывод и вставьте на удалённом сервисе. Если проблема сохраняется, удалите старый ключ и создайте новый (ssh-keygen -t ed25519).