Как создать папку в GitHub-репозитории

Создать репозиторий на GitHub просто: укажите имя, выберите лицензию и README, загрузите файлы. Но добавить новую папку внутри уже существующего репозитория напрямую через кнопку невозможно. К счастью, существует несколько простых способов добавить директорию в репозиторий — ниже пошаговые инструкции и полезные дополнительные материалы.

Создать папку путём создания временного файла

Перейдите на страницу репозитория и нажмите Add file > Create new file.

В поле «Name your file» введите имя директории с косой чертой в конце. Например, чтобы создать папку «test», введите «test/».

GitHub автоматически распознает путь и покажет новую директорию. Однако изменения не сохранятся, если внутри неё не будет хотя бы одного файла. Введите имя файла внутри директории (например, README.md или .gitkeep), затем нажмите Commit changes. Можно оставить стандартное сообщение коммита.

После коммита вернитесь на страницу репозитория и убедитесь, что папка появилась. Если это была временная заглушка (например, .gitkeep), вы можете её удалить позже или заменить на реальные файлы.

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

Загрузить папку из проводника (с компьютера)

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

1. На компьютере создайте папку и поместите в неё текстовый файл (временный файл).
2. На странице репозитория выберите Add file > Upload files.

3. Перетащите папку в область загрузки или нажмите Choose your files и выберите файлы через проводник.

После загрузки подтвердите коммит — и папка появится в репозитории.

Замечание: для массовых изменений удобнее использовать Git локально и выполнить стандартный рабочий процесс (git add, git commit, git push).

Альтернативные подходы

• Git CLI: Создайте папку локально, добавьте в неё файлы, выполните git add <путь>, git commit и git push. Это даёт полный контроль над историей и ветками.
• GitHub Desktop: Удобен для пользователей, предпочитающих GUI. Создаёте папку локально, затем коммиты и push через приложение.
• Интеграции CI/CD: Некоторые рабочие процессы требуют создания директорий автоматически — это делается скриптами в пайплайнах (например, при генерации артефактов).

Когда метод не работает

• Если вы пытаетесь сохранить пустую директорию — GitHub «не примет» её, потому что в Git хранятся только файлы. Обход — положить пустой файл-«заглушку» (.gitkeep, .gitignore или README).
• Если у вас нет прав на запись в репозиторий, вы не сможете выполнить коммит через веб-интерфейс или пушить изменения. В таком случае создайте форк или запросите доступ.

Короткая методология (шаг за шагом)

1. Решите, будете ли вы работать через веб-интерфейс, локально через Git или через GitHub Desktop.
2. Если веб: используйте Create new file (с путём) или Upload files (перетаскивание папки).
3. Если локально: mkdir path && touch path/.gitkeep && git add . && git commit -m “Добавить папку” && git push.
4. Проверьте репозиторий и при необходимости удалите временные файлы.

Контрольные списки по ролям

• Владелец/maintainer:

  • Проверить права доступа участников.
  • При необходимости создать шаблоны .gitignore и README в новой директории.
  • Убедиться, что структура соответствует конвенциям проекта.

• Участник/contributor:

  • Создать директорию локально или через веб-интерфейс с временным файлом.
  • Выполнить коммит и отправить изменения в отдельной ветке при необходимости PR.

• Ревьюер:

  • Проверить, нужны ли тесты или документация в новой папке.
  • Оценить влияние на сборку/CI.

Критерии приёмки

• Директория отображается в структуре репозитория.
• Внутри есть как минимум один релевантный файл (README, код, конфигурация).
• Название и структура соответствуют гайдлайнам проекта.
• Изменения корректно задокументированы в сообщении коммита.

Устранение неполадок и откат

• Если вы случайно добавили временный файл в основную ветку, удалите его в отдельном коммите и запишите осмысленное сообщение (git rm path/.gitkeep && git commit).
• Если нужно отменить последний коммит, используйте git revert или git reset в зависимости от сценария и прав доступа.
• При проблемах с правами связи обратитесь к владельцу репозитория или откройте issue.

Краткий словарь

• Коммит: сохранённое изменение в истории Git.
• Push: отправка локальных коммитов в удалённый репозиторий.
• .gitkeep: условный пустой файл, используемый для того, чтобы директория появилась в Git.

Заключение

Добавление папки в GitHub — простая задача, если помнить, что Git хранит файлы, а не пустые директории. Для быстрой работы используйте веб-интерфейс и временные файлы; для более сложных сценариев — Git CLI или GitHub Desktop. Включите в новую директорию README и, при необходимости, тесты, чтобы поддерживать понятную структуру проекта.

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