Сценарии
Инструменты

Гит

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

Зачем организовывать свой код?

Если у вас более одного сценария, согласованная структура папок сэкономит время и упростит контроль версий.

Настройка структуры папок кода

Один из самых простых способов организовать ваши проекты — создать специальную папку кода на локальном компьютере. Внутри этой папки вы можете создавать подпапки для каждого проекта или репозитория. Вот рекомендуемая структура папок:

/home/your-username/code/
  ├── project1/
  ├── project2/
  └── project3/

Каждая подпапка (например, project1) представляет собой репозиторий, в котором вы будете хранить файлы и код этого проекта.

Что такое репозиторий?

Репозиторий (или репо) — это, по сути, папка с содержимым, которое отслеживает Git. Когда вы создаете репозиторий локально, вы инициализируете Git в этой папке, что позволяет вам сохранять любые изменения в онлайн-клоне.

Local and Remote Repositories

  • Локальный репо: это репозиторий, хранящийся на вашем компьютере в одной из папок вашего проекта.
  • Удаленный репозиторий: версия репозитория, хранящаяся в Интернете (например, на GitLab или GitHub).

Использование Git и GitHub

После создания структуры папок вы можете инициализировать Git и подключить свои локальные проекты к GitHub. Чтобы начать, выполните следующие действия:

Основные шаги по использованию Git и GitHub

  1. Установить Git
  2. Создайте учетную запись GitHub
  3. Создайте пустой репозиторий на GitHub
  4. Инициализируйте Git в своем локальном проекте
  5. Подключите свой локальный репозиторий к GitHub
  6. Подготовьте свои файлы
  7. Зафиксируйте изменения
  8. Отправьте свои изменения на GitHub
  9. Просмотрите свой репозиторий онлайн

1. Установите Git

Если вы еще не установили Git, вы можете сделать это в Linux, используя:

sudo apt install git

2. Создайте учетную запись GitHub

Если у вас еще нет учетной записи, посетите GitHub, чтобы зарегистрироваться. После регистрации вы сможете создавать репозитории на GitHub для хранения своего кода в Интернете.

3. Создайте пустой репозиторий на GitHub

  1. Войдите в GitHub: перейдите на GitHub и войдите в свою учетную запись.
  2. Создайте новый репозиторий: – Нажмите значок +* в правом верхнем углу и выберите Новый репозиторий.
    • Введите имя репозитория (например, your-repository).
    • При желании добавьте описание. – Выберите Общедоступный или Частный доступ.
    • Не инициализируйте репозиторий с помощью README, .gitignore или лицензии (во избежание конфликтов). – Нажмите Создать репозиторий.

4. Инициализируйте Git в своем локальном проекте

Чтобы начать отслеживать папку проекта с помощью Git, откройте терминал, перейдите к папке проекта и запустите:

cd code/your/project/folder
git init

Эта команда инициализирует пустой репозиторий Git в папке вашего проекта.

5. Подключите свой локальный репозиторий к GitHub

Далее вам нужно подключить свой локальный репозиторий к GitHub. После создания пустого репозитория на GitHub добавьте его в качестве удаленного в свой локальный проект:

cd code/your/project/folder
git remote add origin https://github.com/your-username/your-repository.git

Замените your-username и your-repository своим фактическим именем пользователя GitHub и именем репозитория. Эта команда связывает ваш локальный проект с удаленным репозиторием на GitHub.

6. Подготовьте файлы

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

git add .
```Это позволит Git отслеживать изменения, внесенные вами во все файлы вашего проекта. Вы также можете подготовить определенные файлы, заменив `.` именем файла.

### 7. Зафиксируйте изменения

После подготовки следующим шагом будет сохранение (или «фиксация») изменений в локальном репозитории Git. При совершении фиксации всегда следует включать сообщение с описанием внесенных вами изменений. Например:

```sh
git commit -m "Add new feature"

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

8. Публикуйте свои изменения на GitHub

После того как вы зафиксировали изменения локально, вы можете «отправить» их на GitHub, чтобы обновить удаленный репозиторий. Выполните следующую команду, чтобы загрузить изменения:

git push -u origin main

Ветка main является веткой по умолчанию в GitHub, где хранится код, и эта команда загружает ваши локальные изменения в удаленный репозиторий, делая их доступными в Интернете.

9. Просмотрите свой код на GitHub

После того как вы отправите свой код на GitHub, вы сможете просмотреть свой репозиторий в веб-интерфейсе GitHub. Вы должны увидеть файлы из вашего локального репозитория, а также историю коммитов, показывающую внесенные вами изменения.

Заключение

Организовав свой код в специальные папки и используя GitHub для управления и резервного копирования своих репозиториев, вы сохраните свои проекты хорошо структурированными и легко доступными. Как только у вас появится рабочая версия кода, отправьте ее на GitHub. Затем вы можете легко отслеживать любые изменения, используя веб-интерфейс GitHub или код Visual Studio, который выделяет измененные строки. Такой подход позволяет вам продолжать совершенствовать и расширять свой код, не теряя при этом прогресса или изменений.

Git и такие платформы, как GitHub и GitLab, являются мощными инструментами, и хотя они могут быть сложными, в Интернете доступно множество ресурсов, которые помогут вам лучше их понять. Один из самых ценных ресурсов, которые я нашел, — это помощники искусственного интеллекта, такие как ChatGPT. Вы можете описать, чего вам нужно достичь, и эти инструменты терпеливо проведут вас шаг за шагом через весь процесс.

Глоссарий

Вот некоторые общие термины, с которыми вы столкнетесь при работе с Git и GitHub:- Коммит: снимок ваших изменений в репозитории. Каждый коммит включает сообщение, описывающее, что было изменено, и создает историческую запись, к которой вы можете обратиться или вернуться к ней позже.

  • Репозиторий (Repo): коллекция файлов и их история, отслеживаемая Git. Репозитории могут существовать локально на вашем компьютере или удаленно на таких платформах, как GitHub. Каждый проект обычно хранится в собственном репозитории.
  • Удаленный. Удаленный репозиторий — это версия вашего проекта, размещенная на такой платформе, как GitHub. Локальная версия вашего проекта на вашем компьютере связана с этим пультом, так что вы можете загружать (извлекать) и загружать (извлекать) изменения.
  • Промежуточный: процесс подготовки файлов к фиксации. Когда вы размещаете файл, вы сообщаете Git, что хотите включить его в следующий коммит. Промежуточное хранение позволяет вам выбирать, какие изменения включать в коммит.
  • Push: действие по отправке зафиксированных вами изменений из локального репозитория в удаленный репозиторий (например, GitHub), чтобы другие могли получить доступ к обновленной версии вашего кода.
  • Pull: получение изменений из удаленного репозитория для обновления локальной копии. Вы извлекаете изменения, когда хотите синхронизировать локальный репозиторий с последней версией из удаленного хранилища.
  • Происхождение: имя по умолчанию для удаленного репозитория при первом подключении локального репозитория к удаленному. Обычно относится к основному URL-адресу вашего проекта на GitHub.
Код Visual Studio