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

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

---

## Установка Git

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

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

```text
https://git-scm.com/downloads
```

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

* Windows
* Linux
* macOS

---

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

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

```bash
git --version
```

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

```text
git version 2.43.0
```

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

---

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

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

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

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

---

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

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

Пример:

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

---

### Указать email

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

Пример:

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

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

---

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

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

```bash
git config --list
```

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

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

---

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

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

```bash
git config user.name
```

Email:

```bash
git config user.email
```

---

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

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

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

---

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

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

```bash
git config --global user.name
```

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

```text
~/.gitconfig
```

---

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

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

```bash
git config user.name "Developer"
```

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

```text
project/.git/config
```

---

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

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

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

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

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

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

---

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

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

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

---

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

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

**Обязательно выдайте разрешение на чтение и запись для repository**

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

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

---

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

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

```text
Username
Password
```

Вводится:

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

---

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

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

---

### Windows

```bash
git config --global credential.helper manager
```

---

### macOS

```bash
git config --global credential.helper osxkeychain
```

---

### Linux

```bash
git config --global credential.helper cache
```

---

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

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

```bash
git config --global --list
```

---

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

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

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

---

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

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

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

---

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

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

---

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

```bash
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-репозиториями.