Realizar o commit e revisar as alterações no seu projeto no GitHub Desktop

Sobre commits

Assim como ao salvar um arquivo que foi editado, um commit registra alterações em um ou mais arquivos no seu branch. O Git atribui a cada commit um ID exclusivo, denominado SHA ou hash, que identifica:

• Cada uma das alterações feitas;
• O momento em que as alterações foram feitas;
• O autor das alterações.

Ao fazer um commit, você deve incluir uma mensagem que descreva brevemente as alterações. Você também pode adicionar um coautor em qualquer commit em que colaborar.

Se os commits que você cria em GitHub Desktop estiverem associados à conta errada no GitHub, atualize o endereço de email na configuração do Git usando GitHub Desktop. Para obter mais informações, confira Configurar o Git para o GitHub Desktop.

Os administradores de repositório podem habilitar conjuntos de regras para uma ramificação para impor convenções específicas ao confirmar. Por exemplo, um conjunto de regras pode exigir que um commit seja sinalizado ou que um número de problema seja referenciado no início de uma mensagem do commit. GitHub Desktop exibirá um aviso e impedirá a confirmação se uma confirmação não seguir os conjuntos de regras. Para saber mais, confira Sobre os conjuntos de regras.

Escolher um branch e fazer alterações

1.        [Crie uma nova ramificação](/desktop/making-changes-in-a-branch/managing-branches-in-github-desktop) ou selecione uma ramificação existente clicando em **<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-git-branch" aria-label="git-branch" role="img"><path d="M9.5 3.25a2.25 2.25 0 1 1 3 2.122V6A2.5 2.5 0 0 1 10 8.5H6a1 1 0 0 0-1 1v1.128a2.251 2.251 0 1 1-1.5 0V5.372a2.25 2.25 0 1 1 1.5 0v1.836A2.493 2.493 0 0 1 6 7h4a1 1 0 0 0 1-1v-.628A2.25 2.25 0 0 1 9.5 3.25Zm-6 0a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Zm8.25-.75a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5ZM4.25 12a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Z"></path></svg> Ramificação Atual** na barra de ferramentas e selecionando a ramificação na lista.
   
   
          ![Captura de tela da exibição suspensa "Ramificação atual". Em "Branches Recentes", um ramo chamado "my-feature" está destacado com um contorno laranja.](/assets/images/help/desktop/select-branch-from-dropdown.png)
   

2. Usando seu editor de texto favorito, como o Visual Studio Code, faça as alterações necessárias nos arquivos do projeto.

Escolhendo como mostrar diffs

Você pode alterar a maneira como os diffs são exibidos em GitHub Desktop para atender às suas necessidades de revisão.

Para mudar a forma como você vê os diffs, no canto superior direito da visualização de diffs, clique em .

• Para alterar como o diff inteiro é exibido, em "Diff display", selecione Unified ou Split. A visualização unificada mostra as alterações linearmente, enquanto a visualização separada mostra conteúdo antigo do lado esquerdo e novo conteúdo do lado direito.
• Para ocultar as alterações de espaço em branco para que você possa se concentrar em alterações mais substantivas, selecione Ocultar Alterações de Espaço em Branco.

Se você precisa ver mais do arquivo do que GitHub Desktop mostra por padrão, você pode expandir o diff.

• Para ver as próximas linhas acima ou abaixo das alterações destacadas, clique na seta acima ou abaixo dos números de linha.
• Para ver o arquivo inteiro, clique com o botão direito na visão de diferenças e clique em Expandir Todo o Arquivo.

Selecionar alterações para inclusão em um commit

As alterações feitas nos arquivos via editor de texto e salvas no local também aparecerão no GitHub Desktop.

Na guia "Alterações" na barra lateral esquerda:

• O ícone vermelho indica os arquivos removidos.

• O ícone amarelo indica os arquivos modificados.

• O ícone verde indica os arquivos adicionados.

• Para acessar as alterações em stash, clique em Alterações em stash.

• Para adicionar todas as alterações em todos os arquivos a um só commit, mantenha a caixa de seleção na parte superior da lista selecionada.

  

• Para adicionar todas as alterações em um ou mais arquivos a um só commit, desmarque as caixas de seleção ao lado dos arquivos que não deseja incluir, deixando apenas os arquivos desejados no commit. Você pode alternar a caixa de seleção com as chaves Spacebar ou Enter depois de selecionar um arquivo.

Criar um commit parcial

Se um arquivo tiver várias alterações e você quiser incluir somente algumas no commit, será possível criar um commit parcial. O restante das alterações ficará intacto, de modo que você possa fazer outras modificações e commits. Essa opção permite fazer commits separados mais relevantes, como manter alterações de quebra de linha em um commit separado das alterações de código.

Para excluir linhas alteradas do seu commit, clique em uma ou mais linhas alteradas para que o azul desapareça. As linhas ainda em destaque em azul serão incluídas no commit.

Descartar alterações

Se você tiver alterações não realizadas que não deseja manter, poderá descartar as alterações. Isso removerá as alterações dos arquivos no seu computador. Você pode descartar todas as alterações não realizadas em um ou mais arquivos ou pode descartar as linhas específicas que adicionou.

As alterações descartadas são salvas em um arquivo datado na Lixeira. Você pode recuperar as alterações descartadas até que a lixeira seja esvaziada.

Descartar alterações em um ou mais arquivos

1. Na lista de arquivos alterados, selecione os arquivos dos quais você deseja descartar as alterações desde o último commit. Para selecionar vários arquivos, clique em shift e clique no intervalo de arquivos dos quais deseja descartar as alterações.

2. Clique em Descartar Alterações ou Descartar Alterações Selecionadas para descartar as alterações feitas em um ou mais arquivos ou Descartar Todas as Alterações para descartar as alterações feitas em todos os arquivos desde o último commit.

          ![Captura de tela da guia "Alterações". Dois arquivos selecionados são realçados em azul. Em um menu de contexto, o cursor passa sobre "Descartar 2 Alterações Selecionadas".](/assets/images/help/desktop/discard-changes-mac.png)
   

Confirmar descarte de arquivos

Descartar alterações em uma ou mais linhas

Você pode descartar uma ou mais linhas alteradas que não foram confirmadas.

Para descartar uma linha adicionada, na lista de linhas alteradas, clique com o botão direito do mouse no número da linha que deseja descartar e selecione Descartar Linha Adicionada.

Para descartar um grupo de linhas alteradas, clique com o botão direito do mouse na barra vertical à direita dos números das linhas que deseja descartar e selecione Descartar linhas adicionadas.

Escreva uma mensagem de commit e faça o push das suas alterações.

Quando estiver satisfeito com as alterações que escolher incluir em seu commit, você precisará descrever o commit e efetuar push das alterações. Se o commit envolveu trabalho em colaboração, será possível atribuí-lo a mais de um autor.

1. Na parte inferior da lista de alterações, ao lado de sua imagem de perfil, descreva o commit:

   • Se você tiver acesso ao GitHub Copilot, poderá criar automaticamente uma mensagem de commit e detalhes com base nas alterações que você fez. Clique em .
   • Se você quiser gerar novamente uma mensagem de confirmação diferente, clique em outra vez para gerar uma nova sugestão.
   • Como alternativa, digite sua própria mensagem de commit curta e significativa no campo Summary. Você também pode adicionar mais informações sobre as alterações no campo Description.
   

2. Para atribuir um commit a outro autor, você também pode clicar no ícone para adicionar coautores e digitar o(s) nome(s) de usuário que pretende incluir.

          ![Captura de tela da guia “Alterações”. No canto do campo “Descrição”, o ícone para adicionar um coautor está contornado em laranja.](/assets/images/help/desktop/add-co-author-commit.png)
   

3. No campo Descrição, clique em Fazer commit de um BRANCH.

   Dica

   Se o seu repositório tiver ganchos de pré-commit ou commit-msg, eles serão automaticamente executados quando você fizer o commit. Você pode ignorar ganchos para uma confirmação específica clicando em ao lado do campo de mensagem de confirmação e selecionando Bypass Commit Hooks. Para saber mais, confira Trabalhando com ganchos do Git no GitHub Desktop.

4. Se o branch com a qual você está tentando fazer commit estiver protegido, o desktop irá avisá-lo.

   • Para mover as alterações, clique em Alternar branches.
   • Para confirmar suas alterações no branch protegido, clique em Confirmar no BRANCH.

   Para obter mais informações sobre branches protegidos, confira Sobre branches protegidos.

5. Para enviar por push as alterações locais no repositório remoto, na barra do repositório, clique em Efetuar push de origem.

   

6. Se você tiver uma solicitação de pull com base no branch em que está trabalhando, GitHub Desktop exibirá o status das verificações que foram executadas para a solicitação de pull ao lado da seção "Branch Atual" da barra do repositório. Para saber mais sobre verificações, confira Exibir e executar novamente verificações no GitHub Desktop.

   Se uma solicitação de pull não tiver sido criada para o branch atual, GitHub Desktop oferecerá a opção de pré-visualizar as alterações e criar uma. Para saber mais, confira Criar um problema ou solicitação de pull do GitHub Desktop.

   

Gerenciando seu histórico de commits

Se você precisar desfazer um commit ou revisar seu histórico de commits (para facilitar o acompanhamento das alterações por um revisor), GitHub Desktop fornece várias opções para gerenciar seu histórico de commits. Para saber mais, confira Opções para gerenciar commits no GitHub Desktop.

Leitura adicional

•         [AUTOTITLE](/get-started/using-git)
  

•         [AUTOTITLE](/desktop/making-changes-in-a-branch/working-with-git-hooks-in-github-desktop)