Skip to main content

Git — Установка и первичная настройка

Эта страница объясняет, как установить Git и выполнить базовую настройку перед началом работы. Здесь разобраны установка Git, настройка имени и email пользователя, проверка конфигурации и настройка хранения учетных данных для работы через HTTPS. Материал рассчитан на начинающих и описывает настройку Git, которую нужно выполнить один раз перед началом работы.

Установка Git

Git необходимо установить на компьютер перед началом работы с репозиториями.

Скачать установщик можно с официального сайта:

https://git-scm.com/downloads

Git доступен для всех основных операционных систем:

  • Windows
  • Linux
  • macOS

Проверка установки

После установки необходимо проверить, что Git доступен в системе.

git --version

Пример результата:

git version 2.43.0

Если команда выполняется успешно — Git установлен правильно.

Первичная настройка Git

Перед началом работы необходимо указать имя пользователя и email.

Эта информация будет использоваться в каждом commit и позволит определить автора изменений.

Настройка выполняется один раз.

Указать имя пользователя

git config --global user.name "Ваше имя"

Пример:

git config --global user.name "Ivan Petrov"

Указать email

git config --global user.email "email@example.com"

Пример:

git config --global user.email "ivan.petrov@flamy.studio"

Важно использовать тот же email, который указан в Gitea.

Проверка конфигурации

Проверить текущие настройки можно так:

git config --list

Пример результата:

user.name=Ivan Petrov
user.email=ivan.petrov@flamy.studio

Проверить конкретный параметр

Имя пользователя:

git config user.name

Email:

git config user.email

Глобальная и локальная конфигурация

Git поддерживает два уровня конфигурации.

Тип Описание
Global применяется ко всем репозиториям
Local применяется только к текущему репозиторию

Глобальная конфигурация

Используется чаще всего.

git config --global user.name

Настройки сохраняются в файле:

~/.gitconfig

Локальная конфигурация

Можно задать настройки только для одного проекта.

git config user.name "Developer"

Настройки сохраняются в файле:

project/.git/config

Работа через HTTPS

В нашей инфраструктуре Git используется через HTTPS.

Пример ссылки репозитория:

https://git.ext.flamy.studio/user/project.git

Это означает, что Git будет запрашивать:

  • логин
  • пароль или access token

Использование Access Token

Вместо пароля рекомендуется использовать Access Token.

Это безопаснее и удобнее.

Создание токена в Gitea

  1. Открыть Settings
  2. Перейти в Applications
  3. Создать New Access Token

После создания токена будет показан секретный ключ.

Его нужно сохранить.

Использование токена

При первом git push Git запросит:

Username
Password

Вводится:

Поле Значение
Username имя пользователя Gitea
Password Access Token

Сохранение учетных данных

Чтобы Git не запрашивал пароль при каждом push, можно включить credential helper.

Windows

git config --global credential.helper manager

macOS

git config --global credential.helper osxkeychain

Linux

git config --global credential.helper cache

Проверка настроек Git

Полезно проверить общую конфигурацию:

git config --global --list

Типичные ошибки при настройке

Неправильный email

Если email отличается от указанного в Gitea, commit может отображаться некорректно.

Не сохранены credentials

Git может запрашивать пароль при каждом push.

Решение — настроить credential helper.

Отсутствие Git в системе

Если команда git не работает, нужно проверить установку.

Краткая памятка

git --version

git config --global user.name "Name"
git config --global user.email "email@example.com"

git config --list
git config --global --list

git config --global credential.helper manager

Итог

Перед началом работы с Git необходимо:

  1. установить Git
  2. указать имя пользователя
  3. указать email
  4. настроить хранение учетных данных

Эти действия выполняются один раз и позволяют корректно работать с Git-репозиториями.

Back to top