Como Verificar se um Repositório Git Possui um Worktree

GitBeginner
Pratique Agora

Introdução

Neste laboratório, você aprenderá como verificar se um repositório Git possui um worktree. Exploraremos o conceito de Git worktrees, que são diretórios de trabalho adicionais conectados ao mesmo repositório, permitindo que você gerencie múltiplos branches simultaneamente.

Você usará o comando git worktree list para identificar os worktrees associados ao seu repositório. Inicialmente, você verá apenas o worktree principal. Ao executar o comando novamente, você confirmará a ausência de worktrees adicionais, estabelecendo as bases para entender como gerenciar múltiplas linhas de desenvolvimento dentro de um único repositório.

Executar git worktree list

Nesta etapa, exploraremos o conceito de Git worktrees e como listá-los. Um worktree é um diretório de trabalho adicional conectado ao mesmo repositório. Isso permite que você tenha múltiplos branches verificados (checked out) ao mesmo tempo, o que pode ser muito útil para multitarefas ou testar diferentes funcionalidades simultaneamente.

Primeiramente, vamos navegar para o diretório do nosso projeto, caso você ainda não esteja lá. Abra seu terminal e digite:

cd ~/project/my-time-machine

Agora, vamos usar o comando git worktree list para ver os worktrees atuais associados ao nosso repositório. Como ainda não criamos nenhum worktree adicional, este comando nos mostrará o worktree principal.

git worktree list

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

/home/labex/project/my-time-machine  a1b2c3d [master]

Esta saída nos informa que nosso worktree principal está localizado em /home/labex/project/my-time-machine, está atualmente no branch master e está apontando para um commit específico (representado pelo commit hash, que será diferente no seu caso).

Entender os worktrees é importante porque eles fornecem uma maneira flexível de gerenciar múltiplas linhas de desenvolvimento dentro de um único repositório. Nas etapas seguintes, aprenderemos como criar e gerenciar esses worktrees adicionais.

Verificar Worktrees Adicionais

Na etapa anterior, usamos git worktree list e vimos apenas uma entrada, que é nosso worktree principal. Isso ocorre porque ainda não criamos nenhum worktree adicional.

Vamos confirmar isso executando o comando novamente e observando a saída. Certifique-se de que você ainda está no diretório ~/project/my-time-machine.

cd ~/project/my-time-machine
git worktree list

A saída ainda deve mostrar apenas uma linha, representando seu worktree principal:

/home/labex/project/my-time-machine  a1b2c3d [master]

Isso confirma que atualmente não há worktrees adicionais associados a este repositório. O comando git worktree list é uma maneira simples, mas poderosa, de ver todos os worktrees ativos de relance. À medida que você criar mais worktrees no futuro, este comando se tornará cada vez mais útil para gerenciar seus diferentes ambientes de desenvolvimento.

Nas próximas etapas, aprenderemos como criar um novo worktree e ver como a saída de git worktree list muda.

Verificar o Status do Worktree Principal

Nesta etapa, usaremos o comando git status dentro do nosso worktree principal para ver seu estado atual. Este comando é essencial para entender quais alterações estão presentes no seu diretório de trabalho atual e na área de staging.

Certifique-se de que você ainda está no diretório do worktree principal:

cd ~/project/my-time-machine

Agora, execute o comando git status:

git status

Como não fizemos nenhuma alteração desde nosso último commit em "Your First Git Lab", a saída deve indicar que a árvore de trabalho está limpa:

On branch master
nothing to commit, working tree clean

Esta saída confirma que não há alterações pendentes para serem commitadas em nosso worktree principal. O comando git status é sua ferramenta principal para obter um resumo do estado atual do seu repositório. Ele informa em qual branch você está, se há alguma alteração para ser commitada e se há arquivos não rastreados.

Nas próximas etapas, introduziremos alterações e criaremos novos worktrees, e você verá como a saída de git status e git worktree list reflete essas ações.

Resumo

Neste laboratório, aprendemos como verificar os Git worktrees usando o comando git worktree list. Navegamos para o nosso diretório do projeto e executamos o comando, observando que, inicialmente, apenas o worktree principal foi listado, confirmando a ausência de worktrees adicionais. Este comando é essencial para identificar e gerenciar múltiplos diretórios de trabalho vinculados a um único repositório Git.