Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы, возможно, еще выполняется. Актуальные сведения см. в документации на английском языке.

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

Запросы на вытягивание позволяют другим пользователям сообщать об изменениях, отправленных в ветвь в репозитории на GitHub. После открытия запроса на вытягивание можно обсудить и просмотреть потенциальные изменения с участниками совместной работы и добавить дальнейшие фиксации, прежде чем изменения будут объединены в базовую ветвь.

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

Примечание. При работе с запросами на вытягивание помните следующее:

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

Запросы на вытягивание можно создавать в GitHub.com, с помощью GitHub Desktop, в GitHub Codespaces, в GitHub Mobile и при использовании интерфейса командной строки GitHub.

После инициализации запроса на вытягивание вы увидите обзорную страницу с общими сведениями о различиях между вашей ветвью (ветвью сравнения) и базовой ветвью репозитория. Здесь можно добавить сводку предлагаемых изменений, просмотреть изменения, внесенные фиксациями, добавить метки, вехи и ответственных, а также отметить (@mention) отдельных участников или команд. Дополнительные сведения см. в разделе Создание запроса на вытягивание.

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

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

Сведения о текущем состоянии развертывания ветви и прошлых действиях развертывания можно просмотреть на вкладке "Беседа". Дополнительные сведения см. в разделе Просмотр действий развертывания для репозитория.

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

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

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

Советы

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

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

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

Черновики запросов на вытягивание доступны в общедоступных репозиториях при использовании GitHub Free для организаций и устаревших планов выставления счетов для каждого репозитория, а также в общедоступных и частных репозиториях при использовании GitHub Team, GitHub Enterprise Server версии 2.17 или более поздней, и GitHub Enterprise Cloud. Дополнительные сведения см. в разделе Продукты GitHub.

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

Когда вы будете готовы получить отзыв о запросе на вытягивание, вы можете пометить черновик запроса на вытягивание как «Готовый к проверке». При пометке запроса на вытягивание как «Готового к проверке» будет запрашиваться проверка всеми владельцами кода. Запрос на вытягивание можно в любой момент преобразовать в черновик. Дополнительные сведения см. в разделе Изменение этапа запроса на вытягивание.

Различия между фиксациями на страницах сравнения и на страницах запроса на вытягивание

На страницах сравнения и на страницах запроса на вытягивание используются различные методы вычисления различий между измененными файлами:

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

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