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

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)

См. также:

Оглавление​

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

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

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

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

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

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

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

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

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

Оглавление