Добавление существующего проекта в GitHub Desktop 📁

У вас есть папка с кодом на компьютере, и вы хотите начать использовать Git? Рассказываем как добавить локальный проект в GitHub Desktop.

Когда это нужно?

• У вас есть папка с кодом, но это ещё не Git репозиторий
• Вы клонировали проект через терминал и хотите открыть в GUI
• Получили архив с проектом от коллеги
• Работали над проектом без Git и решили начать версионирование

Вариант 1: Добавить существующий Git репозиторий

Если папка уже является Git репозиторием (есть .git папка):

Шаги:

1. Открой GitHub Desktop
2. File → Add Local Repository
3. Нажми Choose… и выбери папку
4. Click Add Repository

✅ Готов о! Репозиторий появился в GitHub Desktop.

Что увидите:

• История коммитов в табе History
• Текущие изменения в Changes (если есть)
• Текущую ветку в заголовке

Вариант 2: Инициализировать новый репозиторий

Если папка не является Git репозиторием:

Шаги:

1. File → Add Local Repository
2. Выбери папку с проектом
3. Увидишь ошибку: “This directory does not appear to be a Git repository”
4. Нажми Initialize Git Repository или create a repository

GitHub Desktop создаст .git папку автоматически!

После инициализации:

1. Все файлы появятся в Changes (неотслеживаемые)
2. Сделай первый коммит:
   - Summary: Initial commit
   - Нажми Commit to main

Вариант 3: Создать новый репозиторий с нуля

Если проекта ещё нет:

Шаги:

1. File → New Repository
2. Заполни:
   - Name: название проекта
   - Description: краткое описание
   - Local Path: где создать
   - ✅ Initialize this repository with a README
   - Git Ignore: выбери template (Python, Node, Java…)
   - License: выбери лицензию (опционально)
3. Create Repository

GitHub Desktop создаст папку и инициализирует Git!

Понимание интерфейса GitHub Desktop

Левая панель: Changes

Показывает изменённые файлы:

✓ новый_файл.py        (зелёный +)
✓ изменённый.js         (жёлтая точка)
✓ удалённый.txt        (красный -)

Галочки — файлы, которые войдут в коммит.
Можно снять галочку чтобы не коммитить файл.

Правая панель: Diff

Показывает что именно изменилось:

function hello() {
-  console.log("Hello");
+  console.log("Hello World!");
}

• Красные строки (- минус) — удалено
• Зелёные строки (+ плюс) — добавлено

Нижняя часть: Commit

Два поля:

1. Summary — краткое описание (обязательно)
2. Description — подробности (опционально)

Частые задачи

Открыть проект в редакторе

1. Repository → Open in Visual Studio Code (или другой редактор)
2. Или: Ctrl+Shift+A (Windows) / Cmd+Shift+A (Mac)

Открыть папку в проводнике

1. Repository → Show in Explorer (Windows)
2. Или: Repository → Show in Finder (Mac)
3. Или: Ctrl+Shift+F / Cmd+Shift+F

Открыть терминал в папке проекта

1. Repository → Open in Terminal
2. Или: Ctrl+** (Windows) / **Cmd+ (Mac)

Настройка .gitignore

После добавления проекта часто нужно настроить .gitignore:

Что это?

Файл .gitignore указывает какие файлы НЕ нужно отслеживать:

• Зависимости (node_modules/, venv/)
• Билды (dist/, build/, *.pyc)
• Конфиги (.env, .idea/, .vscode/)
• Системные (.DS_Store, Thumbs.db)

Как добавить:

1. Repository → Repository Settings → Ignored Files
2. Или создай файл .gitignore в корне проекта

Примеры шаблонов:

Python:

__pycache__/
*.py[cod]
venv/
.env

Node.js:

node_modules/
.npm
.env
dist/

Общее:

.DS_Store
.idea/
.vscode/
*.log

Устранение проблем

“This directory appears to be a Git repository”

Папка уже Git репозиторий! Просто:
- File → Add Local Repository (не создавать новый!)

“The repository is missing or not accessible”

Проверьте:
- Путь правильный?
- Есть ли access права к папке?
- Не удалили ли .git папку?

Слишком много неотслеживаемых файлов

Настройте .gitignore до первого коммита:

1. Добавьте .gitignore с нужными шаблонами
2. Удалите ненужные файлы из Changes
3. Сделайте коммит

Пример: добавить проект Python

# У вас есть проект
my-python-app/
├── app.py
├── requirements.txt
└── venv/              # НЕ нужно в Git!

Шаги:

1. Открой GitHub Desktop
2. File → Add Local Repository
3. Выбери my-python-app/
4. Нажми create a repository
5. Создай .gitignore:
   venv/ __pycache__/ *.pyc .env
6. В Changes останутся только app.py и requirements.txt
7. Сделай коммит: Initial commit

✅ Готово! Проект под Git!

Что дальше?

После добавления проекта:

1. ✅ Опубликуй на GitHub (Publish repository)
2. ✅ Настрой .gitignore
3. ✅ Делай коммиты при изменениях
4. ✅ Создавай ветки для новых фич

Теперь ваш проект под надёжной защитой Git! 🚀