Registrar alterações em commits locais

Crie uma pasta nova chamada pratica-commits, separada dos seus outros projetos. Ela pode começar vazia. Durante o tutorial, use apenas arquivos fictícios, sem dados pessoais ou sensíveis.

O comando git init inicia um repositório na pasta atual do terminal. Entre em pratica-commits e confira o caminho completo usando a navegação que você já conhece. Essa pasta será a raiz do projeto: o ponto de partida para seus arquivos e subpastas.

Com o terminal dentro de pratica-commits, execute:

O Git deve confirmar a inicialização e indicar o caminho da pasta .git dentro de pratica-commits. O comando prepara o repositório, mas não cria um commit. Você não precisa repetir git init a cada commit.

Com o repositório pronto, diferencie estas três áreas:

• Arquivos de trabalho: são os arquivos da pasta do projeto que você abre, edita e salva.
• Área de preparação: guarda a seleção de conteúdo destinada ao próximo commit. Preparar ainda não é registrar no histórico.
• Histórico: reúne as versões já registradas em commits no seu computador.

Salvar uma edição, preparar conteúdo e registrar um commit são ações distintas.

Na pasta do repositório, execute o comando abaixo. Ele consulta o estado do projeto: não altera seus arquivos nem cria commits.

A saída pode aparecer em inglês. Leia os títulos dos blocos:

• Untracked files — arquivos não rastreados: ainda fora do acompanhamento do Git.
• Changes not staged for commit — alterações de arquivos rastreados que não estão preparadas.
• Changes to be committed — alterações preparadas para o próximo commit, ainda não registradas.

Nem todos os blocos aparecem em toda consulta.

Observe este exemplo de saída, com outras linhas omitidas. new file significa “arquivo novo”; modified, “modificado”.

Em outro momento, a consulta pode terminar com esta mensagem:

Isso significa “nada a registrar; arquivos de trabalho sem alterações pendentes”. O Git não indica pendências nesse estado. Os arquivos continuam na pasta: limpo não significa vazio.

Em outro exemplo, a saída apresenta apenas estes dois blocos de pendências:

Salve o arquivo no editor. No terminal, use git add seguido do nome para preparar o conteúdo salvo daquele arquivo no momento do comando. Os outros arquivos não são preparados automaticamente.

Para preparar apenas resumo.txt, que está na pasta atual:

Agora teste na pasta de prática já inicializada. Crie e salve no editor tarefas.txt e rascunho.txt, com uma linha de conteúdo fictício em cada um. Deixe os dois na raiz do projeto e, no terminal aberto nessa pasta, execute os comandos abaixo.

Primeiro prepare o arquivo escolhido; depois consulte o estado para conferir a seleção.

Após preparar apenas tarefas.txt, este trecho mostra a situação dos dois arquivos:

Com a seleção conferida, use git commit -m para registrar uma versão a partir da área de preparação. Alterações que ficaram fora dela não entram nesse commit.

Por exemplo, se você preparou um arquivo novo com a apresentação do projeto:

A opção -m permite informar a mensagem no próprio comando.

Após executar o comando, confira a confirmação com a mensagem do commit e o resumo das mudanças. Se aparecer um erro, não considere o registro concluído.

Para um arquivo com duas linhas adicionadas, um trecho desse resumo pode ser:

O resumo indica um arquivo alterado e duas linhas adicionadas.

No cenário de tarefas.txt, o primeiro commit foi confirmado com sucesso. Em seguida, git status mostrou este trecho:

Depois do primeiro commit, editar e salvar um arquivo rastreado cria uma nova alteração não preparada. Ser rastreado não significa ter as novas edições preparadas automaticamente.

O primeiro bloco lista alterações preparadas; o segundo, alterações não preparadas. O mesmo arquivo pode aparecer nos dois. O git add prepara o conteúdo salvo naquele momento: uma edição posterior não atualiza essa seleção.

Voltando ao cenário antes de criar o commit: você quer registrar Horário: 11h. Como essa linha já está salva, execute git add novamente pelo nome do arquivo e confira o estado:

Sem novas edições, aviso.txt aparecerá apenas no bloco de alterações preparadas. A seleção agora contém Horário: 11h, pronta para entrar no próximo commit.

Crie uma pasta vazia chamada jardim-pratica, fora de outros repositórios. Confirme que o terminal está nessa pasta e inicialize o repositório.

No editor, crie e salve apenas estes dois arquivos fictícios:

• plano.txt: Projeto: Jardim de teste.
• tarefas.txt: Separar sementes.

Não use dados pessoais ou sensíveis.

Consulte o estado, prepare somente plano.txt pelo nome e consulte novamente para conferir a seleção.

Crie o primeiro commit com uma mensagem curta e específica, escolhida por você. Confira a confirmação do comando e consulte o estado depois.

Deixe tarefas.txt para o segundo commit. Guarde os comandos e as saídas para a conferência final.

1. Prepare tarefas.txt pelo nome.
2. Acrescente a linha Local: varanda. em plano.txt, salve e prepare esse arquivo.
3. Acrescente outra linha em plano.txt: Cultivo: manjericão. Salve, mas ainda não prepare novamente.
4. Consulte git status e observe plano.txt com alterações preparadas e não preparadas.

Ainda não crie o segundo commit.