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
- Открыть Settings
- Перейти в Applications
- Создать New Access Token
Обязательно выдайте разрешение на чтение и запись для repository
После создания токена будет показан секретный ключ.
Его нужно сохранить.
Использование токена
При первом 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 необходимо:
- установить Git
- указать имя пользователя
- указать email
- настроить хранение учетных данных
Эти действия выполняются один раз и позволяют корректно работать с Git-репозиториями.