Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

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.

Neste artigo

Sobre commits

Em um processo semelhante ao de salvar um arquivo, um commit é uma alteração em um ou mais arquivos do branch. O Git atribui um ID exclusivo (chamado SHA ou hash) a cada commit, e o ID monitora:

  • 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. Também é possível incluir um coautor em quaisquer commits que envolverem trabalho colaborativo.

1. Escolher um branch e fazer alterações

  1. Crie um branch ou selecione um branch existente clicando em Current Branch (Branch atual) na barra de ferramentas. Em seguida, selecione o branch na lista.
    Menu suspenso para alternar o branch atual
  2. Usando seu editor de texto favorito, como o Atom, faça as alterações necessárias nos arquivos do seu projeto.

2. 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 alterados.
  • O ícone verde indica os arquivos adicionados.
  • Para acessar as alterações stashed, clique em Stashed Changes (Alterações stashed). Opção Stashed Changes (Alterações stashed)
  • Para adicionar todas as alterações em todos os arquivos a um único 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 único commit, desmarque todas as caixas de seleção ao lado dos arquivos que você não quer incluir, deixando apenas os arquivos que você quer no commit. É possível alternar a caixa de seleção com as teclas Barra de espaços 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.

Durante a revisão do diff do arquivo, as linhas a serem incluídas no commit ficam destacadas em azul. Para excluir a alteração, clique na linha alterada para que o destaque azul desapareça.

Linhas desmarcadas em um arquivo

Descartar alterações

Você pode descartar todas as alterações sem commits em um arquivo ou intervalo de arquivos. Também é possível descartar todas as alterações em todos os arquivos desde a última confirmação.

  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 shift e clique no intervalo de arquivos dos quais você deseja descartar as alterações.

    Selecionar vários arquivos com alterações para descartar

  2. Clique em Discard Changes (Descartar alterações) ou Discard Selected Changes (Descartar alterações selecionadas) para descartar as alterações em um ou mais arquivos ou clique em Discard All Changes (Descartar todas as alterações) para descartar alterações em todos os arquivos desde o último commit.

    Opção Discard Changes (Descartar alterações) no menu de contexto

  3. Para confirmar as alterações, revise os arquivos afetados e clique em Discard Changes (Descartar alterações).

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

Dica: as alterações descartadas são salvas em um arquivo com data em Trash (Lixeira), e será possível recuperá-las até que a lixeira seja esvaziada.

  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 shift e clique no intervalo de arquivos dos quais você deseja descartar as alterações.

    Selecionar vários arquivos com alterações para descartar

  2. Clique em Discard Changes (Descartar alterações) ou Discard Selected Changes (Descartar alterações selecionadas) para descartar as alterações em um ou mais arquivos ou clique em Discard All Changes (Descartar todas as alterações) para descartar alterações em todos os arquivos desde o último commit.

    Opção Discard Changes (Descartar alterações) no menu de contexto

  3. Para confirmar as alterações, revise os arquivos afetados e clique em Discard Changes (Descartar alterações).

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

Dica: as alterações descartadas são salvas em um arquivo com data em Recycle Bin (Lixo), e será possível recuperá-las até a lixeira ser esvaziada.

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

  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 do commit

  3. No campo Description (Descrição), clique em Commit to BRANCH (Fazer commit para o BRANCH).

    Botão Commit (Fazer commit)

  4. If the branch you're trying to commit to is protected, Desktop will warn you.

    • To move your changes, click switch branches.
    • To commit your changes to the protected branch, click Commit to BRANCH.

    For more information about protected branches, see "About protected branches".

    Protected branch warning

  5. Clique em Push origin (Fazer push de origem) ou Force push origin (Forçar push de origem) para fazer push de suas alterações para o remote.

    Botão Push

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato