# Criar um problema

Os problemas podem ser criados de várias maneiras. Portanto, você pode escolher o método mais conveniente para seu fluxo de trabalho.

Os problemas podem ser usados para acompanhar erros, aprimoramentos ou outras solicitações. Para saber mais, confira [Sobre problemas](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/learning-about-issues/about-issues).

Os administradores do repositório podem desabilitar problemas para um repositório. Para saber mais, confira [Desabilitar problemas](/pt/enterprise-server@3.22/repositories/managing-your-repositorys-settings-and-features/enabling-features-for-your-repository/disabling-issues).

## Criar um problema a partir de um repositório

1. Em GitHub, acesse a página principal do repositório.

2. No nome do seu repositório, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="issue-opened" role="img"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"></path></svg> Issues**.

   ![Captura de tela da página principal de um repositório. Na barra de navegação horizontal, uma guia, rotulada como "Problemas", é destacada em laranja escuro.](/assets/images/help/repository/repo-tabs-issues-global-nav-update.png)

3. Clique em **Novo problema**.

4. Se o repositório usar modelos de problemas, ao lado do tipo de problema que você deseja abrir, clique em **Introdução**.

   Se o tipo de problema que você deseja abrir não estiver incluído nas opções disponíveis, clique em **Abrir um problema em branco**.

![Captura de tela do seletor de modelo de um problema. Abaixo das opções de modelo, há um link rotulado "Abrir um problema em branco" com o contorno em laranja escuro.](/assets/images/help/issues/blank-issue-link.png)

1. No campo “Título”, digite um título para o problema.

2. No campo do corpo do comentário, digite uma descrição para o problema.
   Para fazer referência cruzada a uma discussão relacionada, cole a URL da discussão na descrição do problema.

3. Se você for um mantenedor de projeto, poderá [atribuir o problema a alguém](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users), [adicioná-lo a umprojeto](/pt/enterprise-server@3.22/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#assigning-a-project-from-within-an-issue-or-pull-request), [associá-lo a um marco](/pt/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests), [definir o tipo](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/editing-an-issue#adding-or-changing-the-issue-type) de problema ou [aplicar um rótulo](/pt/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels).

4. Quando terminar, clique em **Enviar novo problema**.

## Criando um problema a partir de um comentário

Você pode abrir um novo tópico a partir de um comentário em um tópico ou pull request. Quando você abre um problema a partir de um comentário, o problema contém um trecho mostrando onde o comentário foi originalmente publicado.

1. Acesse o comentário que você deseja abrir a partir de um problema.

2. Neste comentário, clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Show options" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>.

   ![Captura de tela de um comentário em uma solicitação de pull. O botão de kebab está contornado em laranja escuro.](/assets/images/help/pull_requests/kebab-in-pull-request-review-comment.png)

3. Clique em **Referência em novo problema**.

4. Use o menu suspenso "Repositório" para selecionar o repositório em que deseja abrir o problema.

5. Digite um título descritivo e o texto do problema.

6. Clique em **Criar problema**.

7. Se você for um mantenedor de projeto, poderá [atribuir o problema a alguém](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users), [adicioná-lo a umprojeto](/pt/enterprise-server@3.22/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#assigning-a-project-from-within-an-issue-or-pull-request), [associá-lo a um marco](/pt/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests), [definir o tipo](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/editing-an-issue#adding-or-changing-the-issue-type) de problema ou [aplicar um rótulo](/pt/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels).

8. Quando terminar, clique em **Enviar novo problema**.

## Criando um problema a partir do código

É possível abrir um problema novo a partir de uma linha ou linhas específicas de código em um arquivo ou pull request. Quando você abre um problema de código, o problema contém um trecho mostrando a linha ou intervalo de código que você escolheu. Você pode abrir somente um problema no mesmo repositório onde o código é armazenado.

1. Em GitHub, acesse a página principal do repositório.

2. Localize o código que deseja referenciar em um problema:
   * Para abrir um problema sobre código em um arquivo, navegue até o arquivo.
   * Para abrir um problema sobre o código em uma solicitação de pull, navegue até a solicitação de pull e clique **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-diff" aria-label="diff" role="img"><path d="M8.75 1.75V5H12a.75.75 0 0 1 0 1.5H8.75v3.25a.75.75 0 0 1-1.5 0V6.5H4A.75.75 0 0 1 4 5h3.25V1.75a.75.75 0 0 1 1.5 0ZM4 13h8a.75.75 0 0 1 0 1.5H4A.75.75 0 0 1 4 13Z"></path></svg> em Arquivos alterados**. Em seguida, procure o arquivo que contém o código que deseja incluir no comentário e clique em **Exibir**.

3. Escolha se deseja selecionar uma linha individual ou um intervalo.

   * Para selecionar uma única linha de código, clique no número de linha para destacá-la.
   * Para selecionar um intervalo de código, clique no número da primeira linha no intervalo para destacar a linha de código. Em seguida, posicione o cursor sobre a última linha do intervalo de códigos, pressione <kbd>SHIFT</kbd> e clique no número de linha para realçar o intervalo.

4. À esquerda do intervalo de códigos, clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-kebab-horizontal" aria-label="Code line X options" role="img"><path d="M8 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3ZM1.5 9a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Zm13 0a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path></svg>. No menu suspenso, clique em **Referência em um novo problema**.

![Captura de tela de um arquivo, com oito linhas selecionadas. À esquerda da primeira linha selecionada, um botão rotulado com um ícone de kebab é descrito em laranja escuro.](/assets/images/help/repository/open-new-issue-specific-line.png)

1. No campo “Título”, digite um título para o problema.
2. No campo do corpo do comentário, digite uma descrição para o problema.
3. Se você for um mantenedor de projeto, poderá [atribuir o problema a alguém](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users), [adicioná-lo a umprojeto](/pt/enterprise-server@3.22/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#assigning-a-project-from-within-an-issue-or-pull-request), [associá-lo a um marco](/pt/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests), [definir o tipo](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/editing-an-issue#adding-or-changing-the-issue-type) de problema ou [aplicar um rótulo](/pt/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels).
4. Quando terminar, clique em **Enviar novo problema**.

## Criando um tópico a partir da discussão

As pessoas com permissão de triagem para um repositório podem criar um problema a partir de uma discussão.

Ao criar um problema a partir de uma discussão, o conteúdo da postagem na discussão será automaticamente incluído no texto do problema e todas as etiquetas serão mantidas. A criação de um problema a partir de uma discussão não converte a discussão em um problema ou exclui a discussão existente. Para obter mais informações sobre GitHub Discussions, confira [Sobre discussões](/pt/enterprise-server@3.22/discussions/collaborating-with-your-community-using-discussions/about-discussions).

1. No nome do repositório ou da organização, clique em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-comment-discussion" aria-label="comment-discussion" role="img"><path d="M1.75 1h8.5c.966 0 1.75.784 1.75 1.75v5.5A1.75 1.75 0 0 1 10.25 10H7.061l-2.574 2.573A1.458 1.458 0 0 1 2 11.543V10h-.25A1.75 1.75 0 0 1 0 8.25v-5.5C0 1.784.784 1 1.75 1ZM1.5 2.75v5.5c0 .138.112.25.25.25h1a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h3.5a.25.25 0 0 0 .25-.25v-5.5a.25.25 0 0 0-.25-.25h-8.5a.25.25 0 0 0-.25.25Zm13 2a.25.25 0 0 0-.25-.25h-.5a.75.75 0 0 1 0-1.5h.5c.966 0 1.75.784 1.75 1.75v5.5A1.75 1.75 0 0 1 14.25 12H14v1.543a1.458 1.458 0 0 1-2.487 1.03L9.22 12.28a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215l2.22 2.22v-2.19a.75.75 0 0 1 .75-.75h1a.25.25 0 0 0 .25-.25Z"></path></svg> Discussions**.

   ![Captura de tela das guias em um repositório GitHub. A opção "Discussões" está contornada em laranja escuro.](/assets/images/help/discussions/repository-discussions-tab-global-nav-update.png)

2. Na lista de discussões, clique na discussão que você deseja visualizar.

3. Na barra lateral direita, clique **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-issue-opened" aria-label="issue-opened" role="img"><path d="M8 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3Z"></path><path d="M8 0a8 8 0 1 1 0 16A8 8 0 0 1 8 0ZM1.5 8a6.5 6.5 0 1 0 13 0 6.5 6.5 0 0 0-13 0Z"></path></svg> em Criar problema da discussão**.

   ![Captura de tela da barra lateral em uma discussão. A opção "Criar problema com base na discussão" está contornada em laranja escuro.](/assets/images/help/discussions/create-issue-from-discussion.png)

4. No campo “Título”, digite um título para o problema.

5. No campo do corpo do comentário, digite uma descrição para o problema.

6. Se você for um mantenedor de projeto, poderá [atribuir o problema a alguém](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/assigning-issues-and-pull-requests-to-other-github-users), [adicioná-lo a umprojeto](/pt/enterprise-server@3.22/issues/planning-and-tracking-with-projects/managing-items-in-your-project/adding-items-to-your-project#assigning-a-project-from-within-an-issue-or-pull-request), [associá-lo a um marco](/pt/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/associating-milestones-with-issues-and-pull-requests), [definir o tipo](/pt/enterprise-server@3.22/issues/tracking-your-work-with-issues/using-issues/editing-an-issue#adding-or-changing-the-issue-type) de problema ou [aplicar um rótulo](/pt/enterprise-server@3.22/issues/using-labels-and-milestones-to-track-work/managing-labels).

7. Quando terminar, clique em **Enviar novo problema**.

## Criar um problema com base em um projeto

Você pode criar problemas rapidamente sem sair do projeto. Ao usar uma exibição agrupada por um campo, a criação de um problema nesse grupo definirá automaticamente o campo do novo problema como o valor do grupo. Por exemplo, se você agrupar a exibição por "Status", ao criar um problema no grupo "Todo", o "Status" do novo problema será definido automaticamente como "Todo". Para obter mais informações sobre projetos, consulte [Sobre o Projects](/pt/enterprise-server@3.22/issues/planning-and-tracking-with-projects/learning-about-projects/about-projects).

1. Navegue até o seu projeto.

2. Na parte inferior de uma tabela, um grupo de itens ou uma coluna no layout do quadro, clique em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-plus" aria-label="plus icon" role="img"><path d="M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z"></path></svg>.

   ![Captura de tela que mostra a linha inferior de uma exibição de tabela. O botão "+" está realçado com um contorno laranja.](/assets/images/help/projects-v2/omnibar-add.png)

3. Clique em **Criar problema**.

4. Na parte superior da caixa de diálogo "Criar problema", selecione o repositório em que você deseja que o problema seja criado.

   ![Captura de tela que mostra a caixa de diálogo "Criar problema".](/assets/images/help/projects-v2/issue-create-form.png)

5. Abaixo do menu suspenso do repositório, digite um título para o novo problema.

6. Opcionalmente, use os campos abaixo do campo de título para definir atributos, rótulos e marcos, além de adicionar o novo problema a outros projetos.

7. Opcionalmente, digite uma descrição para o problema.

8. Opcionalmente, para criar mais problemas, selecione **Criar mais** e a caixa de diálogo será reaberta.

9. Clique em **Criar**.

## Criando um problema a partir de uma consulta de URL

Você pode usar parâmetros de consulta para abrir problemas. Os parâmetros de consulta são partes opcionais de uma URL que podem ser personalizadas para compartilhar uma exibição de página da Web específica, como resultados do filtro de pesquisa ou um modelo de issue no GitHub. Para criar seus próprios parâmetros de consulta, você deve corresponder o par de chave e valor.

> \[!TIP]
> Também é possível criar modelos de problemas abertos com rótulos padrão, responsáveis e um título para o problema. Para saber mais, confira [Usando modelos para incentivar problemas úteis e receber pull request](/pt/enterprise-server@3.22/communities/using-templates-to-encourage-useful-issues-and-pull-requests).

Você deve ter as permissões adequadas para qualquer ação para usar o parâmetro de consulta equivalente. Por exemplo, é preciso ter permissão para adicionar um rótulo a um problema a fim de usar o parâmetro de consulta `labels`. Para saber mais, confira [Funções de repositório para uma organização](/pt/enterprise-server@3.22/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization).

Se você criar uma URL inválida usando parâmetros de consulta ou se não tiver as permissões adequadas, a URL retornará uma página de erro `404 Not Found`. Se você criar uma URL que exceda o limite do servidor, a URL retornará uma página de erro `414 URI Too Long`.

| Parâmetro de consulta                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Exemplo |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- |
| `title`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |         |
| `https://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report` cria um problema com o rótulo "bug" e o título "Novo relatório de bugs".                                                                                                                                                                                                                                                                                                                                                     |         |
| `body`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |         |
| `https://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem.` cria um problema com o título "Novo relatório de bugs" e o comentário "Descreva o problema" no corpo do problema.                                                                                                                                                                                                                                                                                            |         |
| `labels`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |         |
| `https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug` cria um problema com os rótulos "preciso de ajuda" e "bug".                                                                                                                                                                                                                                                                                                                                                                           |         |
| `milestone`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |         |
| `https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones` cria um problema com o marco "testando marcos".                                                                                                                                                                                                                                                                                                                                                                                 |         |
| `assignees`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |         |
| `https://github.com/octo-org/octo-repo/issues/new?assignees=octocat` cria um problema e o atribui a @octocat.                                                                                                                                                                                                                                                                                                                                                                                                   |         |
| `projects`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |         |
| `https://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1` cria um problema com o título "Correção de bug" e o adiciona ao projeto 1 da organização.                                                                                                                                                                                                                                                                                                                                  |         |
| `template`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |         |
| `https://github.com/octo-org/octo-repo/issues/new?template=issue_template.md` cria um problema com um modelo no corpo do problema. O parâmetro de consulta `template` funciona com modelos armazenados em um subdiretório `ISSUE_TEMPLATE` na raiz no diretório `docs/` ou `.github/` em um repositório. Para saber mais, confira [Usando modelos para incentivar problemas úteis e receber pull request](/pt/enterprise-server@3.22/communities/using-templates-to-encourage-useful-issues-and-pull-requests). |         |

## Criar um problema com GitHub CLI

A GitHub CLI é uma ferramenta de código aberto para uso do GitHub na linha de comando do computador. Quando você está trabalhando na linha de comando, você pode usar GitHub CLI para economizar tempo e evitar mudar o contexto. Para saber mais sobre GitHub CLI, consulte [Sobre GitHub CLI](/pt/enterprise-server@3.22/github-cli/github-cli/about-github-cli).

Para criar uma questão, use o subcomando `gh issue create`. Para ignorar os prompts interativos, inclua os sinalizadores `--body` e `--title`.

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION"
```

Você também pode especificar responsáveis, etiquetas, marcos e projetos.

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --assignee @me,USERNAME --label "LABEL-1,LABEL-2" --project PROJECT-NAME --milestone "MILESTONE-NAME"
```

Para definir o tipo de problema, use o `--type` sinalizador.

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --type "ISSUE-TYPE"
```

Para criar o problema como um subproblema de um pai existente, use o sinalizador `--parent` com um número ou URL do problema.

```shell
gh issue create --title "TITLE" --body "ISSUE-DESCRIPTION" --parent PARENT-ISSUE-NUMBER
```

## Leitura adicional

* [Como escrever no GitHub](/pt/enterprise-server@3.22/get-started/writing-on-github)