Skip to main content

Создание запроса на включение изменений

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

Кто эту функцию можно использовать?

Anyone with read access to a repository can create a pull request.

Platform navigation

Если вы хотите создать новую ветвь для запроса на вытягивание и у вас нет разрешений на запись в репозитории, можно сначала создать вилку репозитория. Дополнительные сведения см. в разделе "[AUTOTITLE" и "Создание запроса на вытягивание из вилки](/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks)".

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

Примечание. Чтобы открыть запрос на вытягивание в общедоступном репозитории, необходимо иметь доступ на запись в головную или исходную ветвь или (для репозиториев, принадлежащих организации) необходимо быть участником организации, которая владеет репозиторием, чтобы открыть запрос на вытягивание.

Можно связать запрос на вытягивание с проблемой, чтобы показать, что выполняется исправление, а также чтобы автоматически закрыть проблему при слиянии запроса на вытягивание. Дополнительные сведения см. в разделе Связывание запроса на вытягивание с проблемой.

Изменение диапазона ветвей и целевого репозитория

По умолчанию запросы на вытягивание основаны на ветвь по умолчанию родительского репозитория. Дополнительные сведения см. в разделе О ветвях.

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

Снимок экрана: запрос на вытягивание. Раскрывающийся список для изменения ветвь сравнения развернут.

При работе с ветвями помните, что базовая ветвь — это то, куда должны применяться изменения, а головная ветвь — это то, откуда берутся изменения.

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

Когда вы изменяете какую-либо информацию в диапазоне ветвей, области предварительного просмотра "Фиксация" и "Файлы изменены" обновляются и показывают новый диапазон.

Совет.

  • С помощью представления сравнения можно настроить сравнения в любом временном интервале. Дополнительные сведения см. в разделе Сравнение фиксаций.
  • Сопровождающие проекта могут добавлять шаблон запроса на вытягивание для репозитория. Шаблоны включают запросы на ввод сведений в тексте запроса на вытягивание. Дополнительные сведения см. в разделе Сведения о шаблонах проблем и запросов на вытягивание.

Создание запроса на вытягивание

  1. На GitHub.comперейдите на главную страницу репозитория.

  2. В меню "Ветвь" выберите ветвь, содержащую фиксации.

    Снимок экрана: раскрывающееся меню ветви на главной странице репозитория.

  3. Над списком файлов в желтом баннере нажмите кнопку "Сравнить" и " Запрос на вытягивание", чтобы создать запрос на вытягивание связанной ветви.

    Снимок экрана: баннер над списком файлов.

  4. В раскрывающемся меню базовой ветви выберите ветвь, в которую вы хотите объединить изменения, а затем в раскрывающемся меню ветви сравнения выберите ветвь раздела, в которую вы внесли изменения.

  5. Введите название и описание для запроса на вытягивание.

  6. Чтобы создать запрос на вытягивание, готовый к проверке, нажмите кнопку Создать запрос на вытягивание. Чтобы создать черновик запроса на вытягивание, нажмите на раскрывающийся список и выберите Создать черновик запроса на вытягивание, а затем Черновик запроса на вытягивание. Дополнительные сведения о черновике запросов на вытягивание см. в разделе "Сведения о запросах на вытягивание".

Совет. После создания запроса на вытягивание можно попросить конкретного пользователя проверить предложенные изменения. Дополнительные сведения см. в разделе Запрос проверки запроса на вытягивание.

После проверки запроса на вытягивание его можно объединить в репозиторий.

Дополнительные сведения о GitHub CLIсм. в разделе "Сведения о GitHub CLI".

Чтобы создать запрос на вытягивание, используйте подкоманду gh pr create.

gh pr create

Чтобы назначить запрос на вытягивание отдельному пользователю, используйте флаги --assignee или -a. Можно использовать @me для назначения запроса на вытягивание самому себе.

gh pr create --assignee "@octocat"

Чтобы указать ветвь, в которую требуется объединить запрос на вытягивание, используйте флаги --base или -B. Чтобы указать ветвь, содержащую фиксации для запроса на вытягивание, используйте флаги --head или -H.

gh pr create --base my-base-branch --head my-changed-branch

Чтобы включить заголовок и текст нового запроса на вытягивание, используйте флаги --title и --body.

gh pr create --title "The bug is fixed" --body "Everything works again"

Чтобы пометить запрос на вытягивание как черновик, используйте флаг --draft.

gh pr create --draft

Чтобы добавить метки или вехи в новый запрос на вытягивание, используйте флаги --label и --milestone.

gh pr create --label "bug,help wanted" --milestone octocat-milestone

Чтобы добавить новый запрос на вытягивание в конкретный проект, используйте флаг --project.

gh pr create --project octocat-project

Чтобы назначить отдельного пользователя или команду в качестве рецензентов, используйте флаг --reviewer.

gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name

Чтобы создать запрос на вытягивание в веб-браузере по умолчанию, используйте флаг --web.

gh pr create --web
  1. Нажмите кнопку "Предварительный просмотр запроса на вытягивание". GitHub Desktop откроет диалоговое окно предварительного просмотра, показывающее различия изменений между текущей ветвью и базовая ветвь.

    Снимок экрана: представление "Нет локальных изменений". Кнопка с меткой "Предварительный запрос на вытягивание" выделена оранжевым контуром.

    Снимок экрана: представление "Нет локальных изменений". Кнопка с меткой "Предварительный запрос на вытягивание" выделена оранжевым контуром.

    Кроме того, чтобы перейти прямо к GitHub для создания запроса на вытягивание, щелкните значок раскрывающегося списка и нажмите кнопку "Создать запрос на вытягивание".

  2. Убедитесь, что ветвь в базе: раскрывающееся меню — это ветвь, в которой необходимо объединить изменения.

    Снимок экрана: диалоговое окно "Открытие запроса на вытягивание". Кнопка со значком раскрывающегося списка, помеченная как base: development, описывается оранжевым цветом.

    GitHub Desktop советует, можно ли автоматически объединить текущую ветвь в базовая ветвь.

    Снимок экрана: диалоговое окно "Открытие запроса на вытягивание". Метка состояния с надписью "Не удается автоматически объединить" выделена оранжевым контуром.

  3. Щелкните Создать запрос на вытягивание. GitHub Desktop откроет браузер по умолчанию с сайтом GitHub.

  4. Введите название и описание для запроса на вытягивание.

  5. Чтобы создать запрос на вытягивание, готовый к проверке, нажмите кнопку Создать запрос на вытягивание. Чтобы создать черновик запроса на вытягивание, нажмите на раскрывающийся список и выберите Создать черновик запроса на вытягивание, а затем Черновик запроса на вытягивание. Дополнительные сведения о черновике запросов на вытягивание см. в разделе "Сведения о запросах на вытягивание".

  1. После фиксации изменений в локальной копии репозитория щелкните значок Создать запрос на вытягивание. Снимок экрана: верхняя часть боковой панели "Управление версиями". Значок запроса на вытягивание выделен темно-оранжевым контуром.
  2. Убедитесь в том, что локальная ветвь и репозиторий, из которых выполняется слияние, а также удаленная ветвь и репозиторий, с которыми выполняется слияние, выбраны правильно. Затем задайте для запроса на вытягивание название и описание. Снимок экрана: боковая панель "GitHub Запрос на вытягивание" с формой для создания запроса на вытягивание, включая поля Title и Description.
  3. Нажмите кнопку Создать.

Дополнительные сведения о создании запросов на вытягивание в GitHub Codespacesсм. в разделе "Использование GitHub Codespaces для запросов на вытягивание".

Дополнительные материалы