Como Verificar se um Arquivo é Rastreável pelo Git

Introdução

Neste laboratório, você aprenderá como verificar se um arquivo está sendo rastreado pelo Git. Exploraremos dois comandos Git essenciais: git ls-files e git status.

Primeiro, você usará git ls-files para listar todos os arquivos atualmente rastreados pelo Git em seu repositório. Em seguida, você usará git status para verificar o status de rastreamento e entender como o Git relata o estado do seu diretório de trabalho quando todas as alterações são confirmadas. Finalmente, você testará como o Git lida com arquivos não rastreados.

Executar git ls-files para Verificar o Arquivo

Nesta etapa, usaremos o comando git ls-files para ver quais arquivos o Git está rastreando atualmente em nosso repositório. Este comando é útil para obter uma visão geral rápida dos arquivos que fazem parte do histórico do seu projeto.

Primeiro, certifique-se de estar no seu diretório my-time-machine. Se você não estiver, use o comando cd para navegar até lá:

cd ~/project/my-time-machine

Agora, execute o comando git ls-files:

git ls-files

Como já criamos e confirmamos o arquivo message.txt nas etapas anteriores, você deve ver o nome deste arquivo na saída:

message.txt

O comando git ls-files lista todos os arquivos que estão sendo rastreados atualmente pelo Git em seu repositório. Estes são os arquivos que o Git está monitorando ativamente em busca de alterações e que estão incluídos em seus commits.

Entender quais arquivos são rastreados é importante porque o Git gerencia apenas o histórico de arquivos rastreados. Quaisquer arquivos que não forem rastreados serão ignorados pelo Git quando você fizer commits. Isso lhe dá controle sobre o que é incluído no histórico de versões do seu projeto.

Nas próximas etapas, exploraremos como o Git lida com arquivos que ainda não foram rastreados.

Usar git status para Verificar o Rastreamento

Na etapa anterior, usamos git ls-files para ver que message.txt é um arquivo rastreado. Agora, vamos usar o comando git status novamente para ver como o Git relata o estado do nosso repositório quando todas as alterações são confirmadas.

Certifique-se de ainda estar no diretório ~/project/my-time-machine.

Execute o comando git status:

git status

Você deve ver uma saída semelhante a esta:

On branch master
nothing to commit, working tree clean

Esta saída nos informa algumas coisas importantes:

• "On branch master": Ainda estamos na linha do tempo principal do nosso projeto.
• "nothing to commit, working tree clean": Esta é a parte chave. Significa que não há alterações em nosso diretório de trabalho que precisem ser confirmadas. O Git vê que o estado atual dos arquivos corresponde ao estado do último commit.

Este é o estado ideal para seu repositório quando você terminou um conjunto de alterações e as confirmou. Indica que seu diretório de trabalho está "limpo" e sincronizado com o último commit.

Comparando esta saída com a saída de git status que vimos antes de criar message.txt e confirmá-lo, você pode ver como a mensagem de status do Git muda para refletir o estado de seus arquivos e commits.

Na próxima etapa, introduziremos um novo arquivo para ver como o status do Git muda quando há arquivos não rastreados presentes.

Testar Arquivos Não Rastreáveis

Nesta etapa, criaremos um novo arquivo em nosso diretório my-time-machine e veremos como o status do Git muda para refletir a presença de um arquivo não rastreado.

Certifique-se de estar no diretório ~/project/my-time-machine.

Crie um novo arquivo chamado notes.txt usando o comando echo:

echo "Some random notes" > notes.txt

Este comando cria um novo arquivo chamado notes.txt e escreve o texto "Some random notes" nele.

Agora, vamos verificar o status do nosso repositório novamente usando git status:

git status

Você deve ver uma saída semelhante a esta:

On branch master
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        notes.txt

nothing added to commit but untracked files present (use "git add" to track)

Observe a seção "Untracked files:". O Git detectou o novo arquivo notes.txt, mas está nos dizendo que ele não está sendo rastreado. Isso ocorre porque ainda não dissemos ao Git para incluir este arquivo no histórico do nosso repositório.

Este é um conceito chave no Git: você precisa dizer explicitamente ao Git quais arquivos você deseja rastrear usando o comando git add. Isso impede que o Git inclua automaticamente todos os arquivos em seu diretório, o que pode incluir arquivos temporários, artefatos de compilação ou anotações pessoais que você não deseja no histórico do seu projeto.

No próximo laboratório, aprenderemos como adicionar este novo arquivo à área de staging (staging area) e confirmá-lo (commit), tornando-o um arquivo rastreado em nosso repositório.

Resumo

Neste laboratório, aprendemos como verificar se um arquivo é rastreado pelo Git. Usamos o comando git ls-files para listar todos os arquivos atualmente rastreados no repositório, confirmando que message.txt estava sendo rastreado.

Em seguida, usamos o comando git status para verificar o estado do repositório. A saída "nothing to commit, working tree clean" indicou que todas as alterações foram confirmadas e que não havia arquivos não rastreados ou alterações pendentes no diretório de trabalho. Isso reforçou nossa compreensão de como o Git relata o status dos arquivos rastreados.