Skip to main content

Fazer commit e revisar as alterações do projeto

À medida que você edita os arquivos, o GitHub Desktop monitora todas as alterações feitas. É possível decidir como você pretende agrupar as alterações para criar commits relevantes.

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 e-mail na configuração do Git usando GitHub Desktop. Para obter mais informações, confira "Como configurar o Git para o GitHub Desktop".

Escolher um branch e fazer alterações

  1. Crie um branch ou selecione um branch existente clicando em Branch Atual na barra de ferramentas e selecionando o branch na lista.

    Menu suspenso usado para alternar o branch atual 1. Usando seu editor de texto favorito, como o Atom, 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 visão diff, clique em .

  • Para alterar a forma como a comparação inteira é exibida, em "Exibição de comparação", selecione Unificada ou Dividida. 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.

Menu de opções do diff

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 todo o arquivo, clique com o botão direito do mouse na exibição de comparação e clique em Expandir Todo o Arquivo.

Expandir visualização do diff

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.

  • 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.

    Opção Stashed Changes (Alterações stashed)

  • 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.

    Caixa de seleção para fazer commit em todos os arquivos alterados

  • 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.

    Caixas de seleção ao lado dos arquivos em que deseja fazer commit

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.

Linhas desmarcadas em um arquivo

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. Seleção de vários arquivos com as alterações a serem descartadas 1. 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.

    Opção Descartar Alterações no menu de contexto 1. Para confirmar as alterações, revise os arquivos afetados e clique em Descartar Alterações.

    Botão Discard Changes (Descartar alterações) na caixa de diálogo Confirmation (Confirmação)

Descartar alterações em uma ou mais linhas

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

Observação: o descarte de linhas simples é desabilitado em um grupo de alterações que adiciona e remove linhas.

Para descartar uma linha adicionada, na lista de linhas alteradas, clique com o botão direito do mouse na linha que deseja descartar e selecione Descartar linha adicionada.

Descartar uma única linha na caixa de diálogo de confirmação

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.

Descartar um grupo de linhas adicionadas na caixa de diálogo de confirmação

Mensagem de commit e envio das alterações

Ao concluir as alterações que você decidiu fazer no commit, escreva a mensagem do commit e envie as alterações. Se o commit envolveu trabalho em colaboração, será possível atribuí-lo a mais de um autor.

Observação: Por padrão, GitHub Desktop fará o push da tag que você criar no seu repositório com o commit associado. Para obter mais informações, confira "Como gerenciar tags".

  1. Na parte inferior da lista de alterações, no campo Summary (Resumo), digite uma mensagem de commit curta e significativa. Como alternativa, é possível adicionar mais informações sobre as alterações no campo Description (Descrição).

    Campo Commit message (Mensagem do commit)

  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.

    Adicionar um coautor à mensagem de commit 1. No campo Descrição, clique em Fazer commit de um BRANCH .

    Botão Confirmar

  3. 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 fazer commit das alterações no branch protegido, clique em **Fazer commit no _BRANCH_**.
    

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

    Aviso de branch protegido 1. Clique em Origem do push para enviar suas alterações locais por push para o repositório remoto. O botão Push

  4. 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. Para saber mais sobre verificações, confira "Exibir e executar novamente verificações no GitHub Desktop".

    Verifica a exibição ao lado do nome do branch

    Se uma solicitação de pull não tiver sido criada para o branch atual, GitHub Desktop oferecerá a opção de criar uma. Para obter mais informações, confira "Como criar um problema ou uma solicitação de pull.”

    Como criar uma solicitação de pull