Перейти к основному содержимому

Решение проблем

9 февраля 2026

Оглавление​

  1. Ошибки при сохранении
  2. Проблемы с отображением
  3. Ошибки форматирования
  4. Проблемы с изображениями
  5. Конфликты при слиянии
  6. Проблемы с Pull Request
  7. Восстановление после ошибок
  8. Где получить помощь

Ошибки при сохранении​

Проблема: Не удаётся сохранить изменения

СимптомРешение
Кнопка "Commit changes" неактивнаПроверьте, что внесены реальные изменения
Ошибка "File not modified"Файл уже сохранён, попробуйте обновить страницу
Ошибка 500Подождите минуту и попробуйте снова

Проблема: Изменения не применяются

  1. Обновите страницу (F5 или Ctrl+R)
  2. Проверьте, что находитесь в правильной ветке
  3. Убедитесь, что нажали "Commit changes"

Проблема: "Changes already committed"

Это означает, что файл уже сохранён. Нажмите "Commits" для просмотра истории.

Проблемы с отображением​

Проблема: Изменения не видны на сайте

ПричинаРешение
Сайт ещё не обновлёнПодождите 5-10 минут
Кэш браузераОчистите кэш (Ctrl+Shift+Del)
Неправильная веткаПроверьте, что изменения в ветке main

Проверка статуса деплоя:

  1. Перейдите в репозиторий на GitHub
  2. Нажмите вкладку "Actions"
  3. Найдите последний workflow run
  4. Проверьте статус: ✅ Success или ❌ Failed

Очистка кэша:

БраузерДействие
ChromeCtrl+Shift+Delete → "Кэшированные изображения и файлы"
FirefoxCtrl+Shift+Delete → "Кэш"
SafariНастройки → "Конфиденциальность" → "Удалить данные"

Принудительное обновление:

  • Windows: Ctrl+F5
  • Mac: Cmd+Shift+R

Ошибки форматирования​

Проблема: Markdown не отображается правильно

ОшибкаКак исправить
Списки не работаютПроверьте пробелы перед элементами списка
Ссылки не кликабельныИспользуйте формат [текст](URL)
Код не подсвеченДобавьте язык после (например,javascript)
Таблица сломанаПроверьте вертикальные линии `

Проверка синтаксиса Markdown:

  1. Скопируйте текст в онлайн-редактор (markdown-it.github.io)
  2. Проверьте предпросмотр
  3. Исправьте ошибки

Распространённые ошибки:

НеправильноПравильно
#Заголовок (без пробела)# Заголовок
[текст](URL (незакрытая скобка)[текст](URL)
**жирный (незакрыто)**жирный**
- пункт (пробелы вместо табуляции)- пункт

Проблемы с изображениями​

Проблема: Изображение не отображается

ПричинаРешение
Неправильный путьПроверьте путь /img/filename.png
Файл не загруженЗагрузите изображение в папку /img/
Большой размерОптимизируйте изображение (до 500 КБ)
Неподдерживаемый форматИспользуйте PNG, JPG, SVG

Проверка пути к изображению:

✅ Правильно:  /img/logo.svg
❌ Неправильно: /images/logo.svg
❌ Неправильно: img/logo.svg
❌ Неправильно: ./img/logo.svg

Проблема: Alt-текст не виден

Alt-текст виден только при отключённых изображениях или для скринридеров. Для проверки отключите изображения в браузере.

Проблема: Изображение слишком большое

  1. Сожмите изображение через tinypng.com
  2. Уменьшите размер в пикселях (максимум 1200px по ширине)
  3. Конвертируйте в WebP для современных браузеров

Конфликты при слиянии​

Что такое конфликт:

Конфликт возникает, когда два человека изменили один и тот же файл в одних и тех же строках.

Как определить конфликт:

  1. При создании Pull Request появится сообщение
  2. Вкладка "Files changed" покажет конфликты
  3. Строки с конфликтами будут помечены

Как разрешить конфликт:

<<<<<<< HEAD (ваша версия)
текст в вашей ветке
=======
текст в основной ветке
>>>>>>> commit-SHA (чужaя версия)
  1. Решите, какую версию оставить (или объедините обе)
  2. Удалите маркеры <<<<<<<, =======, >>>>>>>
  3. Сохраните файл
  4. Создайте коммит для разрешения конфликта

Разрешение конфликта через веб-интерфейс:

  1. Откройте вкладку "Files changed" в PR
  2. Нажмите "Resolve conflicts"
  3. Выберите версию для каждого конфликта
  4. Нажмите "Mark as resolved"
  5. Создайте коммит

Проблемы с Pull Request​

Проблема: PR не создаётся

ПричинаРешение
Нет измененийВнесите изменения и сохраните
Нет доступаЗапросите права у мейнтейнера
Ветка защищенаСоздайте PR из форка

Проблема: Review не назначается

  1. Проверьте, что выбрали правильного рецензента
  2. Возможно, рецензент недоступен
  3. Попробуйте назначить другого

Проблема: PR заблокирован

Причины блокировки:

  • ❌ Есть конфликты слияния
  • ❌ Провалены проверки (CI/CD)
  • ❌ Рецензент запросил изменения

Как разблокировать:

  1. Разрешите конфликты (если есть)
  2. Исправьте ошибки в коде
  3. Дождитесь одобрения рецензента

Проблема: Хочу закрыть PR

  1. Прокрутите вниз страницы PR
  2. Нажмите "Close pull request"
  3. Подтвердите закрытие

Восстановление после ошибок​

Случайно удалили файл:

  1. Перейдите в историю файла
  2. Найдите последний коммит, где файл существовал
  3. Скопируйте содержимое
  4. Создайте новый файл с тем же именем
  5. Сделайте коммит

Случайно перезаписали файл:

  1. Откройте историю файла
  2. Найдите предыдущую версию
  3. Скопируйте содержимое
  4. Внесите изменения в текущий файл
  5. Создайте коммит с описанием: revert: Restore correct version

Случайно удалили коммит:

# Найти потерянный коммит
git reflog

# Восстановить
git checkout <SHA-коммита>

Восстановление из резервной копии:

# Скачать репозиторий заново
git clone https://github.com/USER/REPO.git

Где получить помощь​

Самостоятельное решение:

РесурсСсылка
Документация GitHubdocs.github.com
Руководство по Markdownmarkdown-guide.org
Вопросы и ответыgithub.community

Помощь от команды:

ВопросКуда обратиться
Технические проблемыIT-отдел
Вопросы по контентуРедактор документации
Проблемы с доступомАдминистратор репозитория

Экстренная помощь:

Если что-то сломалось критически:

  1. Не паникуйте
  2. Опишите проблему
  3. Прикрепите скриншот ошибки
  4. Дождитесь помощи

Чек-лист диагностики​

ШагПроверка
1Обновите страницу (F5)
2Проверьте подключение к интернету
3Очистите кэш браузера
4Проверьте статус GitHub (githubstatus.com)
5Проверьте статус деплоя (вкладка Actions)
6Проверьте консоль браузера (F12)

См. также: