n1ro°
RU

Документы · Инструкция

GitHub Actions workflow не запускается: branches, paths и события

Чаще всего workflow «молчит» не из-за runner, а из-за фильтра события, неверной ветки, пути или YAML-файла, который ещё

Редакция N1RO · Проверено

Короткий ответ

Проверьте блок `on`: workflow стартует только когда событие и все заданные branch/path-фильтры совпали. Если одновременно заданы `branches` и `paths`, должны выполниться оба условия.

Что делать

  1. Откройте workflow: Проверьте `.github/workflows/*.yml` в ветке, где ожидаете запуск.
  2. Сверьте событие: Убедитесь, что `push`, `pull_request`, `schedule` или другое событие действительно соответствует действию.
  3. Проверьте filters: Сопоставьте фактическую ветку с `branches/branches-ignore` и изменённые файлы с `paths/paths-ignore`.
  4. Проверьте glob-порядок: Для положительных и отрицательных `!`-паттернов порядок имеет значение.
  5. Сделайте минимальный тест: Временно оставьте событие без path-фильтра в тестовой ветке и верните фильтры после подтверждения запуска.

Важно

Не меняйте required check на необязательный только для обхода неверного path-filter: skipped workflow может оставлять check Pending.

Что учитывать

Не меняйте required check на необязательный только для обхода неверного path-filter: skipped workflow может оставлять check Pending.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. Workflow syntax for GitHub Actions). Пример и формулировки — редакция N1RO на 2026-09-17.