Решение проблем
9 февраля 2026
Оглавление
- Ошибки при сохранении
- Проблемы с отображением
- Ошибки форматирования
- Проблемы с изображениями
- Конфликты при слиянии
- Проблемы с Pull Request
- Восстановление после ошибок
- Где получить помощь
Ошибки при сохранении
Проблема: Не удаётся сохранить изменения
| Симптом | Решение |
|---|---|
| Кнопка "Commit changes" неактивна | Проверьте, что внесены реальные изменения |
| Ошибка "File not modified" | Файл уже сохранён, попробуйте обновить страницу |
| Ошибка 500 | Подождите минуту и попробуйте снова |
Проблема: Изменения не применяются
- Обновите страницу (F5 или Ctrl+R)
- Проверьте, что находитесь в правильной ветке
- Убедитесь, что нажали "Commit changes"
Проблема: "Changes already committed"
Это означает, что файл уже сохранён. Нажмите "Commits" для просмотра истории.
Проблемы с отображением
Проблема: Изменения не видны на сайте
| Причина | Решение |
|---|---|
| Сайт ещё не обновлён | Подождите 5-10 минут |
| Кэш браузера | Очистите кэш (Ctrl+Shift+Del) |
| Неправильная ветка | Проверьте, что изменения в ветке main |
Проверка статуса деплоя:
- Перейдите в репозиторий на GitHub
- Нажмите вкладку "Actions"
- Найдите последний workflow run
- Проверьте статус: ✅ Success или ❌ Failed
Очистка кэша:
| Браузер | Действие |
|---|---|
| Chrome | Ctrl+Shift+Delete → "Кэшированные изображения и файлы" |
| Firefox | Ctrl+Shift+Delete → "Кэш" |
| Safari | Настройки → "Конфиденциальность" → "Удалить данные" |
Принудительное обновление:
- Windows: Ctrl+F5
- Mac: Cmd+Shift+R
Ошибки форматирования
Проблема: Markdown не отображается правильно
| Ошибка | Как исправить |
|---|---|
| Списки не работают | Проверьте пробелы перед элементами списка |
| Ссылки не кликабельны | Используйте формат [текст](URL) |
| Код не подсвечен | Добавьте язык после (например,javascript) |
| Таблица сломана | Проверьте вертикальные линии ` |
Проверка синтаксиса Markdown:
- Скопируйте текст в онлайн-редактор (markdown-it.github.io)
- Проверьте предпросмотр
- Исправьте ошибки
Распространённые ошибки:
| Неправильно | Правильно |
|---|---|
#Заголовок (без пробела) | # Заголовок |
[текст](URL (незакрытая скобка) | [текст](URL) |
**жирный (незакрыто) | **жирный** |
- пункт (пробелы вместо табуляции) | - пункт |
Проблемы с изображениями
Проблема: Изображение не отображается
| Причина | Решение |
|---|---|
| Неправильный путь | Проверьте путь /img/filename.png |
| Файл не загружен | Загрузите изображение в папку /img/ |
| Большой размер | Оптимизируйте изображение (до 500 КБ) |
| Неподдерживаемый формат | Используйте PNG, JPG, SVG |
Проверка пути к изображению:
✅ Правильно: /img/logo.svg
❌ Неправильно: /images/logo.svg
❌ Неправильно: img/logo.svg
❌ Неправильно: ./img/logo.svg
Проблема: Alt-текст не виден
Alt-текст виден только при отключённых изображениях или для скринридеров. Для проверки отключите изображения в браузере.
Проблема: Изображение слишком большое
- Сожмите изображение через tinypng.com
- Уменьшите размер в пикселях (максимум 1200px по ширине)
- Конвертируйте в WebP для современных браузеров
Конфликты при слиянии
Что такое конфликт:
Конфликт возникает, когда два человека изменили один и тот же файл в одних и тех же строках.
Как определить конфликт:
- При создании Pull Request появится сообщение
- Вкладка "Files changed" покажет конфликты
- Строки с конфликтами будут помечены
Как разрешить конфликт:
<<<<<<< HEAD (ваша версия)
текст в вашей ветке
=======
текст в основной ветке
>>>>>>> commit-SHA (чужaя версия)
- Решите, какую версию оставить (или объедините обе)
- Удалите маркеры
<<<<<<<,=======,>>>>>>> - Сохраните файл
- Создайте коммит для разрешения конфликта
Разрешение конфликта через веб-интерфейс:
- Откройте вкладку "Files changed" в PR
- Нажмите "Resolve conflicts"
- Выберите версию для каждого конфликта
- Нажмите "Mark as resolved"
- Создайте коммит
Проблемы с Pull Request
Проблема: PR не создаётся
| Причина | Решение |
|---|---|
| Нет изменений | Внесите изменения и сохраните |
| Нет доступа | Запросите права у мейнтейнера |
| Ветка защищена | Создайте PR из форка |
Проблема: Review не назначается
- Проверьте, что выбрали правильного рецензента
- Возможно, рецензент недоступен
- Попробуйте назначить другого
Проблема: PR заблокирован
Причины блокировки:
- ❌ Есть конфликты слияния
- ❌ Провалены проверки (CI/CD)
- ❌ Рецензент запросил изменения
Как разблокировать:
- Разрешите конфликты (если есть)
- Исправьте ошибки в коде
- Дождитесь одобрения рецензента
Проблема: Хочу закрыть PR
- Прокрутите вниз страницы PR
- Нажмите "Close pull request"
- Подтвердите закрытие
Восстановление после ошибок
Случайно удалили файл:
- Перейдите в историю файла
- Найдите последний коммит, где файл существовал
- Скопируйте содержимое
- Создайте новый файл с тем же именем
- Сделайте коммит
Случайно перезаписали файл:
- Откройте историю файла
- Найдите предыдущую версию
- Скопируйте содержимое
- Внесите изменения в текущий файл
- Создайте коммит с описанием:
revert: Restore correct version
Случайно удалили коммит:
# Найти потерянный коммит
git reflog
# Восстановить
git checkout <SHA-коммита>
Восстановление из резервной копии:
# Скачать репозиторий заново
git clone https://github.com/USER/REPO.git
Где получить помощь
Самостоятельное решение:
| Ресурс | Ссылка |
|---|---|
| Документация GitHub | docs.github.com |
| Руководство по Markdown | markdown-guide.org |
| Вопросы и ответы | github.community |
Помощь от команды:
| Вопрос | Куда обратиться |
|---|---|
| Технические проблемы | IT-отдел |
| Вопросы по контенту | Редактор документации |
| Проблемы с доступом | Администратор репозитория |
Экстренная помощь:
Если что-то сломалось критически:
- Не паникуйте
- Опишите проблему
- Прикрепите скриншот ошибки
- Дождитесь помощи
Чек-лист диагностики
| Шаг | Проверка |
|---|---|
| 1 | Обновите страницу (F5) |
| 2 | Проверьте подключение к интернету |
| 3 | Очистите кэш браузера |
| 4 | Проверьте статус GitHub (githubstatus.com) |
| 5 | Проверьте статус деплоя (вкладка Actions) |
| 6 | Проверьте консоль браузера (F12) |
См. также: