Git Init: Como inicializar e configurar um repositório Git

Você já excluiu um arquivo por engano ou substituiu seu código sem ter como recuperá-lo? Sem o controle de versão, esses erros podem ser catastróficos. É aí que entra o git init - ele transforma a pasta do seu projeto em um repositório Git, garantindo que todas as alterações sejam rastreáveis e recuperáveis. 

Neste tutorial, mostrarei como configurar o Git, compartilharei dicas pessoais da minha jornada e ajudarei você a criar um fluxo de trabalho robusto desde o início.

O que é o Git Init?

O comando git init dá início à sua jornada de controle de versão. Quando você o executa, o Git cria uma pasta oculta .git dentro do diretório do seu projeto que armazena dados de configuração, histórico de commits e todos os metadados necessários para rastrear suas alterações. 

Com cada modificação registrada, você pode ramificar, mesclar e colaborar com confiança, sabendo que o histórico completo do seu projeto está sempre a apenas um comando de distância.

Imagem do autor

Como usar o Git Init

Antes de entrar em tópicos avançados, é essencial que você entenda como usar o git init na prática.

Uso básico do git init

Siga estas etapas para criar um novo repositório Git do zero:  

• Abra seu terminal: Inicie a interface de linha de comando de sua preferência.
• Navegue até o diretório do seu projeto:

cd /path/to/your/project

Isso altera a pasta atual para a que você deseja rastrear.

• Inicializar o repositório: 

git init

Após a execução desse comando, é criada uma pasta oculta .git. Nessa pasta, você armazena todas as informações de rastreamento do Git.

• Verifique o status do repositório:

git status

Nesse estágio, o Git está configurado, mas não está rastreando nenhum arquivo.

Inicialização de um repositório com um projeto existente

Para projetos que ainda não estão sob controle de versão, você pode inicializar o Git e começar a rastrear as alterações da seguinte forma:

• Navegue até o diretório do seu projeto:

cd /path/to/your/project

• Converta o projeto em um repositório Git:

git init

Como mencionado anteriormente, o comando acima cria a pasta oculta .git que permite o rastreamento do Git.

• Organize seus arquivos: Como o git init não rastreia automaticamente os arquivos, você deve adicioná-los com:

git add .

• Confirme seus arquivos: Salve o instantâneo inicial executando:  

git commit -m "Initial commit"

Esse processo converte um projeto não gerenciado em um projeto com um histórico completo de versões, pronto para novos desenvolvimentos e colaborações.

Configuração do Git (se necessário)

Se você encontrar o erro "Author Identity Unknown" (Identidade do autor desconhecida), isso significa que o Git não sabe quem você é. Para corrigir isso, configure sua identidade de usuário:

• Configure as informações do usuário do Git: 

git config --global user.email "your_email@example.com"
git config --global user.name "Your Name"

O uso do site --global aplica essas configurações a todos os repositórios em seu computador. Se você omitir isso, definirá a identidade apenas para o repositório atual.

• Verifique sua configuração:  

git config --global user.email
git config --global user.name

• Tente novamente o commit:  

git commit -m "First Commit"

Encontrei esse erro quando comecei a usar o Git - a configuração da minha identidade resolveu o problema.

O commit inicial do Git foi executado com êxito no PowerShell.

Conectando-se a um repositório remoto

Depois de inicializar um repositório Git localmente, você provavelmente desejará fazer backup dele ou colaborar com outras pessoas conectando-o a um repositório remoto (por exemplo, GitHub, GitLab, Bitbucket).

• Adicione um repositório remoto: Para vincular seu repositório local a um repositório remoto, use:

git remote add origin <repository-url>

Substitua pelo URL do seu repositório remoto. origin é o alias padrão do repositório remoto, mas você pode usar qualquer nome.

• Você pode verificar a conexão com:

git remote -v

• Envie suas alterações para o repositório remoto:

# Push the first commit and track the remote branch
git push -u origin $(git branch --show-current)  # Works for 'main' or 'master' 

O comando acima empurra o ramo atual e o define para rastrear o ramo remoto.

Se você estiver usando uma versão mais antiga do Git que não seja compatível com $(git branch --show-current), use:

git push -u origin main  # Or 'master' depending on your default branch  

À medida que continuar trabalhando no projeto, você precisará mesclar alterações de diferentes ramificações ao colaborar com uma equipe. Saiba como lidar com mesclagens de formaeficaz com este tutorial de mesclagem do Git.

Autenticação e acesso

Se estiver fazendo push para o GitHub, GitLab ou Bitbucket, talvez você precise se autenticar. Dependendo da sua configuração, você pode:

• Use chaves SSH em vez de autenticação HTTPS (recomendado para segurança):

git remote set-url origin git@github.com:your-username/your-repo.git

• Use um Personal Access Token (PAT) em vez de uma senha ao usar HTTPS. Para o GitHub, substitua a senha por um token:

git push https://your-username@github.com/your-repo.git

Conectar-se a um repositório remoto foi um ponto de virada para mim - ele validou que meu trabalho local tinha um backup seguro e estava pronto para colaboração. Além disso, isso me deu confiança no controle de versão, pois sabia que meu histórico seria preservado mesmo se meu computador local falhasse.