8.3 Removendo Arquivos do Rastreamento via `git rm`

Às vezes, um arquivo já está sendo rastreado pelo Git, mas você percebe que ele não deveria estar no repositório. Isso pode acontecer quando você esquece de adicioná-lo ao .gitignore ou quando ele deixa de ser relevante. Nesses casos, você pode usar o comando git rm para removê-lo do repositório e garantir que ele não seja rastreado no futuro.

Como Funciona

O comando git rm remove arquivos do controle de versão do Git. Por padrão, ele exclui o arquivo tanto do repositório quanto do seu computador (diretório local). No entanto, é possível preservar o arquivo no diretório usando opções específicas.

Estrutra

git rm [opções] arquivo

Esse comando remove o arquivo tanto do repositório quanto do seu diretório local.

Casos de Uso

1. Remover um Arquivo do Repositório e do Diretório

Se você deseja excluir um arquivo do repositório e apagá-lo do seu computador, use:

git rm exemplo.txt

2. Remover um Arquivo Apenas do Controle de Versão (Sem Excluir Localmente)

Se o arquivo já está no repositório, mas você quer que o Git pare de rastreá-lo sem apagá-lo do disco, use a opção --cached:

git rm --cached exemplo.txt

Após isso, adicione o arquivo ao .gitignore para evitar que ele seja rastreado novamente.

3. Remover Diretórios Inteiros

Se precisar remover um diretório inteiro e todos os seus arquivos, use a opção -r:

git rm -r pasta/

O diretório e todos os arquivos dentro dele serão apagados do seu computador. Use --cached para manter os arquivos no diretório local.

Confirmando a Remoção

Após usar git rm, o arquivo será removido do rastreamento, mas a alteração precisa ser confirmada em um commit.

1. Verifique o status dos arquivos:

git status

1. Remova o arquivo do repositório:

git rm --cached temp.log

1. Confirme a remoção:

git commit -m "Remover temp.log do repositório"

Considerações Finais

• Desfazendo a Remoção: Se você removeu um arquivo por engano e ainda não fez o commit, pode restaurá-lo com:

git restore arquivo

• Removendo um Arquivo do Histórico do Repositório: Para remover um arquivo de todo o histórico do Git (e não apenas da versão atual), é necessário usar comandos avançados como git filter-branch ou git rebase, que não serão abordados aqui.

Dicas Importantes:

• Sempre use git status antes de remover arquivos para evitar exclusões acidentais.

• Faça backup (cópia) de arquivos importantes antes de removê-los do Git.

Esta é uma explicação simplificada para fins didáticos. Para explorar todas as possibilidades do comando gitrm, consulte a documentação oficial.