Novo no Git? Construa Esses 7 Bons Hábitos Desde o Primeiro Dia

Desde o rastreamento do histórico de um projeto até a consolidação do código, o Git se tornou uma pedra angular do desenvolvimento de software moderno. Como tal, aprender a usar o Git corretamente é importante para qualquer desenvolvedor que deseja colaborar com outros. Neste artigo, vou passar por algumas dicas para iniciantes no Git para ajudá-lo a construir um bom hábito no Git hoje.

1. Defina o Nome de Usuário e o Email do Usuário

Uma das primeiras coisas que você deve fazer no Git é definir seu nome de usuário e email padrão. Isso permite que você marque corretamente seus commits, facilitando para os outros se referirem ao seu código e entrarem em contato com você no futuro.

Para definir seu nome de usuário e email, execute os seguintes comandos em uma nova sessão de terminal:

git config--global user.name "SEU NOME"  
git config--global user.email "SEU ENDEREÇO DE EMAIL"

Você também pode definir essas variáveis através do seu arquivo de configuração pessoal do Git. Para isso, use seu editor de texto favorito para abrir ou criar um arquivo .gitconfig no seu diretório inicial:

ano ~/.gitconfig

Cole as seguintes linhas de código dentro do seu arquivo de configuração:

[user]  
name= SEU-NOME-AQUI  
email= SEU-EMAIL-AQUI

Salve seu arquivo de configuração e, em seguida, confirme se o Git o lê corretamente executando o seguinte comando:

git config--list

2. Crie Alias para Funções Comuns

Não é segredo que o Git é um programa complexo. Com sua infinidade de subcomandos e opções, o Git pode ser, às vezes, esmagador para novos desenvolvedores. Um truque que você pode usar é criar aliases para esses comandos, tornando-os mais fáceis de lembrar.

Para criar um novo alias, cole o seguinte comando em uma nova sessão de terminal:

git config--global alias."CHAVE""SUBCOMANDO"

Substitua o espaço reservado CHAVE pelo alias que você deseja para seu subcomando. No meu caso, vou definir o subcomando “status” para a chave “sta.”

Semelhante à definição do nome de usuário e email do Git, você também pode usar o arquivo .gitconfig no seu diretório inicial para definir novos aliases. Para isso, cole o seguinte bloco de código dentro do seu arquivo .gitconfig:

[alias]  
    sta = status  
    fet = fetch

Salve seu arquivo .gitconfig e, em seguida, confirme se está funcionando corretamente usando seu novo alias.

3. Aproveite o .gitignore

Códigos ativos frequentemente vêm com arquivos que você pode não querer rastrear no controle de versão. Esses podem ser arquivos de objeto restantes ou até mesmo notas temporárias no diretório raiz do repositório. Com o tempo, esses arquivos desnecessários podem se acumular, ocupando espaço no disco do seu PC.

Uma maneira de corrigir isso é criando um arquivo .gitignore dentro do seu repositório Git. Este é um arquivo que informa ao Git quais arquivos ignorar ao criar commits. Para criar um arquivo .gitignore, execute o seguinte dentro do seu repositório:

nano ~/SEU-REPOSITORIO-GIT/.gitignore

Forneça o caminho dos arquivos que você deseja excluir dentro do arquivo .gitignore. No meu caso, não quero incluir um arquivo de nota dentro do diretório “temp” do meu repositório.

Confirme se seu arquivo está funcionando corretamente fazendo alterações no seu repositório de código.

A propósito: você é um usuário do Emacs? Aprenda como você pode usar o Git no Emacs com o aplicativo Magit.

4. Escreva Mensagens de Commit Concisas

Mensagens de commit são uma parte central de todo projeto Git. Elas fornecem detalhes sobre as alterações que você fez, tornando seu repositório mais fácil de navegar a longo prazo. No entanto, se você não as fizer corretamente, as mensagens de commit também podem ser uma fonte de frustração.

Assim, outro bom hábito a ser construído ao usar o Git é ser conciso com suas mensagens de commit. Por padrão, a prática padrão é manter suas mensagens em uma única linha e com menos de 50 caracteres.

Dito isso, há instâncias em que você pode querer elaborar sobre um commit específico. Para esses casos, certifique-se de manter o comprimento da linha da sua mensagem abaixo de 72 caracteres por linha. Isso garantirá que seu commit ainda seja legível em terminais pequenos e emails.

5. Utilize Ramificações do Git

As ramificações do Git são uma ferramenta incrível que pode criar várias versões do seu código no mesmo repositório. Isso permite que você desenvolva um novo código enquanto mantém uma cópia limpa de sua fonte original. Para alguém novo no Git, criar ramificações é um hábito importante a ser adquirido, pois simplifica o processo de integração de novo código ao seu programa.

Para criar uma nova ramificação, navegue até seu repositório Git e, em seguida, execute o seguinte comando:

git checkout-b minha-ramificacao

Confirme que você se mudou para a ramificação “minha-ramificacao” executando git status, e então faça algumas alterações no seu código. No meu caso, vou editar um arquivo de texto dentro do meu repositório.

Finalize suas alterações executando git commit, e então volte para sua ramificação principal executando git checkout master.

Abra os arquivos que você alterou na nova ramificação para confirmar que os arquivos alterados não aparecem na ramificação master.

Bom saber: procurando se aventurar na auto-hospedagem? Confira algumas das melhores alternativas ao Github que podem ser auto-hospedadas hoje.

6. Verifique o Diff Antes de Mesclar Código

O Git, em si, oferece um grande benefício para simplificar o desenvolvimento de recursos, testes e integração de código. No entanto, há casos em que mesclar código não é tão simples quanto parece. Por exemplo, introduzir código de uma ramificação de recurso pode quebrar funções existentes na ramificação master.

Para evitar isso, você deve verificar as diferenças entre as duas ramificações antes de mesclar o código. No Git, você pode fazer isso usando o comando diff.

git diff master..minha-ramificacao

Além disso, o comando diff pode verificar a diferença entre dois arquivos dentro da mesma ramificação. Isso é útil se você tiver várias cópias do mesmo arquivo e quiser verificar rapidamente quaisquer alterações significativas entre elas.

Além disso, ele também pode criar patches a partir de seus arquivos. Estes são pequenos pedaços de texto legíveis por máquina que outros podem usar para aplicar suas alterações ao repositório Git deles.

7. Use Git Fetch em vez de Git Pull

Quando se trata de colaboração, o Git oferece ferramentas para facilitar o compartilhamento e a obtenção de trabalho de outros desenvolvedores. Comandos como git pull, por exemplo, permitem que você busque e aplique atualizações para repositórios em seu sistema local.

Dito isso, uma desvantagem do git pull é que ele aplica automaticamente as alterações no upstream à sua cópia local. Isso é um grande problema se você estiver trabalhando com várias pessoas em uma ramificação de recurso ou rastreando um problema no programa.

Para evitar que isso aconteça, um bom hábito a ser adotado é mudar de git pull para git fetch. Isso apenas puxa as últimas atualizações do upstream do repositório e não mescla nenhum código à sua cópia local.

Para mesclar quaisquer alterações, você pode executar git merge seguido pelo nome da ramificação que deseja integrar.

Aprender esses hábitos do Git é apenas o primeiro passo para explorar o maravilhoso mundo do desenvolvimento de software e software focado em colaboração. Aprenda como você pode expandir ainda mais seu conhecimento sobre Git verificando as diferenças entre Github e Gitlab.

Crédito da imagem: Grok via x.ai. Todas as alterações e capturas de tela por Ramces Red.