Создание проблемы

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

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

People with read access can create an issue in a repository where issues are enabled.

В этой статье

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

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

Создание проблемы из репозитория

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

  2. В поле имени репозитория щелкните Issues.

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

  3. Щелкните Новая проблема.

  4. Если репозиторий использует шаблоны проблем, рядом с типом проблемы, которую вы хотите открыть, нажмите кнопку "Начать".

    Если тип проблемы, которую вы хотите открыть, не включен в доступные параметры, нажмите кнопку "Открыть пустую проблему".

           ![Снимок экрана: средство выбора шаблона для проблемы. Под выбором шаблона выделена ссылка с надписью «Открыть пустой выпуск» тёмно-оранжевым цветом.](/assets/images/help/issues/blank-issue-link.png)
    1. В поле "Заголовок" введите заголовок проблемы.
    2. В поле текста комментария введите описание проблемы. Чтобы сопоставить связанное обсуждение, вставьте URL обсуждения в описание проблемы.

  5. Если вы являетесь помощником по проекту, вы можете назначить проблему кому-либо, добавить ее в проект, связать ее с вехой, задать тип проблемы, или применить метку.

  6. Закончив, нажмите кнопку Отправить новую проблему.

Создание проблемы с GitHub CLI

          GitHub CLI — это инструмент с открытым исходным кодом для использования GitHub из командной строки компьютера. При работе с командной строкой можно использовать GitHub CLI — это позволит экономить время и не переключать контекст. Чтобы узнать больше о GitHub CLI, смотрите [AUTOTITLE](/github-cli/github-cli/about-github-cli).

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

gh issue create --title "My new issue" --body "Here are more details."

Также можно указать уполномоченных пользователей, метки, вехи и проекты.

gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"

Создание проблемы из комментария

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

  1. Перейдите к комментарию, из которого хотите создать проблему.

  2. В этом комментарии нажмите .

    Снимок экрана: комментарий по запросу на вытягивание. Кнопка кебаб выделена темно-оранжевым цветом.

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

  4. В раскрывающемся меню "Репозиторий" выберите репозиторий, в который нужно открыть проблему.

  5. Введите содержательное название и текст проблемы.

  6. Щелкните Создать проблему.

  7. Если вы являетесь помощником по проекту, вы можете назначить проблему кому-либо, добавить ее в проект, связать ее с вехой, задать тип проблемы, или применить метку.

  8. Закончив, нажмите кнопку Отправить новую проблему.

Создание проблемы из кода

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

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

  2. Найдите код, на который хотите сослаться в проблеме:

    • Чтобы создать проблему по коду из файла, откройте этот файл.
    • Чтобы открыть проблему с кодом в pull request, перейдите в pull request и нажмите Files changed. Затем откройте файл, содержащий код, который необходимо включить в комментарий, и щелкните Просмотреть.

  3. Выберите, следует ли выбрать одну строку или диапазон.

    • Для выбора одной строки кода, щелкните номер строки, чтобы выделить ее.
    • Для выбора диапазона щелкните номер первой строки диапазона, чтобы выделить ее. Затем наведите указатель мыши на последнюю строку диапазона кода, нажмите клавишу SHIFT и щелкните номер строки, чтобы выбрать весь диапазон.

  4. Слева от диапазона кодов нажмите . В раскрывающемся меню щелкните Ссылку в новой проблеме.

           ![Снимок экрана: файл с выбранными 8 строками. Слева от первой выбранной строки тёмно-оранжевым цветом обведена кнопка с изображением кебаба.](/assets/images/help/repository/open-new-issue-specific-line.png)

  5. В поле "Заголовок" введите заголовок проблемы.

  6. В поле текста комментария введите описание проблемы.

  7. Если вы являетесь помощником по проекту, вы можете назначить проблему кому-либо, добавить ее в проект, связать ее с вехой, задать тип проблемы, или применить метку.

  8. Закончив, нажмите кнопку Отправить новую проблему.

Создание проблемы из обсуждения

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

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

  1. Под именем репозитория или организации щелкните Обсуждения.

    Снимок экрана: вкладки в репозитории GitHub . Параметр "Обсуждения" описан в темно-оранжевый.

  2. В списке обсуждений щелкните обсуждение, которое нужно просмотреть.

  3. В правой боковой панели нажмите «Создать проблему из обсуждения».

    Снимок экрана боковой панели в обсуждении. Параметр "Создать проблему из обсуждения" описан в темно-оранжевый.

  4. В поле "Заголовок" введите заголовок проблемы.

  5. В поле текста комментария введите описание проблемы.

  6. Если вы являетесь помощником по проекту, вы можете назначить проблему кому-либо, добавить ее в проект, связать ее с вехой, задать тип проблемы, или применить метку.

  7. Закончив, нажмите кнопку Отправить новую проблему.

Создание проблемы из проекта

          Вы можете быстро создавать проблемы, не покидая проект. При использовании представления, сгруппированного по полю, создание проблемы в этой группе автоматически присвоит полю новой проблемы значение группы. Например, если вы группируют представление по состоянию, при создании проблемы в группе "Todo" новая проблема автоматически будет иметь значение "Todo". Для получения дополнительной информации о проектах см. [AUTOTITLE](/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects).

  1. Перейдите к своему проекту

  2. В нижней части таблицы, группы элементов или столбца в макете доски щелкните .

    Снимок экрана: нижняя строка представления таблицы. Кнопка "+" выделена оранжевым контуром.

  3. Нажмите кнопку "Создать новую проблему".

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

    Снимок экрана: диалоговое окно "Создание новой проблемы".

  5. Под раскрывающимся списком репозитория введите заголовок новой проблемы.

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

  7. При необходимости введите описание проблемы.

  8. При необходимости, если вы хотите создать дополнительные проблемы, нажмите кнопку "Создать больше ", а при создании проблемы откроется диалоговое окно.

  9. Нажмите кнопку Создать.

Создание проблемы из элемента списка задач

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

Создание проблемы из запроса URL-адреса

Для создания проблем можно использовать параметры запроса. Параметры запроса — это необязательные части URL, которые можно настроить для совместного просмотра конкретной веб-страницы, например, результаты фильтра поиска или шаблон проблемы на GitHub. Чтобы создать собственные параметры запроса, необходимо сопоставить пару ключа и значения.

Совет

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

Чтобы использовать эквивалентный параметр запроса, необходимо иметь соответствующие разрешения для любого действия. Например, потребуется разрешение, чтобы добавить метку в проблему для использования параметра запроса labels. Дополнительные сведения см. в разделе Роли репозиториев для организации.

Если вы создаете недопустимый URL-адрес с помощью параметров запроса или у вас нет соответствующих разрешений, URL-адрес вернет страницу 404 Not Found ошибки. Если вы создаете URL-адрес, превышающий ограничения сервера, он вернет страницу ошибки 414 URI Too Long.

Параметр запросаПример
title
          `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` создает проблему с меткой "ошибка" и названием "Новый отчет об ошибках".

body | https://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. создает проблему с названием "Новый отчет об ошибках" и комментарием "Описание проблемы" в тексте проблемы. labels | https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug создает проблему с метками "нужна помощь" и "ошибка". milestone | https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones создает проблему с вехой "Тестирование вех". assignees | https://github.com/octo-org/octo-repo/issues/new?assignees=octocat создает проблему и назначает ее пользователю @octocat. projects | https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 создает проблему с заголовком "Исправление ошибок" и добавляет ее в проект 1 организации. template | https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md создает проблему с шаблоном в тексте проблемы. Параметр запроса template поддерживает шаблоны, хранящиеся в корневом подкаталоге ISSUE_TEMPLATE, а также в каталогах docs/ и .github/ в репозитории. Дополнительные сведения см. в разделе Использование шаблонов для описания важных проблем и выполнения запросов на вытягивание.

Вы также можете использовать параметры запроса URL для заполнения пользовательских текстовых полей, которые вы определили в шаблонах формы выпуска. Параметры запроса для полей формы проблемы также можно передать в средство выбора шаблона проблемы. Дополнительные сведения см. в разделе Синтаксис схемы форм GitHub.

Создание проблемы с Копилот Чат on GitHub

Примечание.

Эта функция уже присутствует public preview и может измениться.

Создание проблем вручную может быть повторяющимся и трудоемким. С Copilotпомощью , вы можете создавать проблемы быстрее, подсказывая на естественном языке или даже загрузив скриншот. Copilot Заполняет заголовок, основное тело, ярлыки, назначенных лиц и многое другое, используя шаблоны и структуру вашего репозитория. См . раздел AUTOTITLE.

Создание проблемы из Копилот ЧатVS Code

Вы также можете создать проблему напрямую из Копилот ЧатVS Code, используя протокол Model Context Protocol (MCP). См . раздел AUTOTITLE.

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