Introdução

Esta parte do guia irá ensinar como começar a usar o Git, cobrindo os conceitos básicos de repositórios, commits, branches e repositórios remotos. Ao final, você estará apto a criar e gerenciar projetos utilizando o Git de forma eficiente, colaborativa e organizada. É crucial entender esses conceitos para garantir um fluxo de trabalho produtivo e evitar problemas comuns ao trabalhar com controle de versão.

Abaixo, você conseguirá aprender a criar um repositório, clonar, fazer o commit, pull e push de arquivos, entre outras funcionalidades.

Criando um Repositório

Para começar a usar o Git em um projeto, é necessário criar um repositório. Isso pode ser feito com o comando git init, que inicializa um repositório Git em um diretório existente.

git init

O comando cria um diretório oculto chamado .git, que contém todos os arquivos necessários para o controle de versão do projeto. Após isso, você pode adicionar arquivos ao repositório e começar a rastrear as alterações.

Após executar o comando, o Git começará a rastrear as alterações no diretório atual. Você pode verificar o status do repositório com o comando:

git status

O git apenas rastreia para arquivos que estão dentro do diretório do repositório, apenas sub-diretórios com arquivos são rastreados. Caso deseje rastrear um sub-diretório, você pode criar um arquivo .gitkeep dentro do sub-diretório desejado.

.gitignore

O arquivo .gitignore é usado para especificar quais arquivos ou diretórios o Git deve ignorar. Isso é útil para evitar o rastreamento de arquivos temporários, de configuração local ou outros que não devem ser incluídos no repositório.

Para criar um arquivo .gitignore, basta adicioná-lo na raiz do repositório e listar os arquivos ou diretórios que deseja ignorar. Por exemplo:

1

Lembre-se de o arquivo .gitignore não deve conter nenhuma extensão, apenas o nome .gitignore.

Após criar ou modificar o .gitignore, certifique-se de que os arquivos listados não estão sendo rastreados pelo Git. Caso já estejam, será necessário removê-los do rastreamento com o comando:

git rm --cached <arquivo-ou-diretório>

Boas Práticas

É importante manter o arquivo .gitignore atualizado e organizado, evitando que arquivos desnecessários (node_modules/, .env, .next/ etc) sejam incluídos no repositório. Além disso, é recomendável usar padrões comuns de .gitignore para linguagens e frameworks específicos. O uso do .gitignore é essencial num ambiente de desenvolvimento colaborativo.

Commits

Commits são usados para salvar alterações no repositório. Cada commit representa um ponto no tempo do projeto, permitindo reverter alterações ou entender o histórico do projeto. É importante fazer commits frequentes e descritivos para manter um bom histórico de alterações.

Antes de realizar um commit, é necessário adicionar os arquivos ao stage utilizando o comando:

git add <arquivo-ou-diretório>

O stage é uma área temporária onde as alterações são armazenadas antes de serem confirmadas no commit final. Para salvar as alterações (commit), use o comando:

git commit -m "Mensagem do commit"

Certifique-se de escrever mensagens claras e descritivas para facilitar o entendimento do histórico de alterações. Usando o padrão de commits semânticos.

Branches

Branches permitem trabalhar em diferentes funcionalidades ou correções sem interferir no código principal. Isso facilita a colaboração em equipe e o desenvolvimento de novas funcionalidades. O Git cria uma branch padrão chamada main (ou master) ao inicializar um repositório. Na maioria dos casos, você deve criar uma nova branch para cada nova funcionalidade ou correção que deseja implementar.

Geralmente também é criada uma branch chamada dev para desenvolvimento, onde as novas funcionalidades são testadas antes de serem mescladas na branch principal; que pode estar em produção. Para criar uma nova branch, use o comando:

git branch <nome-da-branch>

Para mudar para a nova branch, use:

git checkout <nome-da-branch>

Ou combine os dois comandos com:

git checkout -b <nome-da-branch>

Para listar todas as branches, use:

git branch

Mesclando Branches

Após finalizar o desenvolvimento de uma nova funcionalidade, você pode mesclar a branch de volta à branch principal. Para isso, primeiro mude para a branch principal (ou a branch que deseja mesclar) e use o comando:

git merge <nome-da-branch>

Isso irá mesclar as alterações da branch especificada na branch atual. Caso haja conflitos, o Git irá solicitar que você resolva os conflitos antes de concluir a mesclagem.

Para excluir uma branch após a mesclagem, use:

git branch -d <nome-da-branch>

Repositórios Remotos

Repositórios remotos permitem colaborar com outras pessoas, compartilhar código e manter um backup do seu projeto. O GitHub é uma plataforma popular para hospedar repositórios remotos. Para usar o GitHub, você precisa criar uma conta e criar um novo repositório.

Após criar um repositório no GitHub, você pode conectar seu repositório local a ele. Para isso, copie a URL do repositório remoto e use o comando:

git remote add origin <url-do-repositório>

Para enviar alterações ao repositório remoto, use:

git push -u origin <nome-da-branch>

Para obter alterações do repositório remoto, use:

git pull origin <nome-da-branch>

Isso irá baixar as alterações do repositório remoto e mesclá-las na branch atual. É importante manter seu repositório local atualizado com as alterações do repositório remoto para evitar conflitos e garantir que você esteja sempre trabalhando com a versão mais recente do código.

Sobre branches remotas, o GitHub permite criar branches diretamente na plataforma, facilitando a colaboração em equipe. Para criar uma branch remota, use o comando:

git push origin <nome-da-branch>

Isso irá criar uma nova branch no repositório remoto com o mesmo nome da branch local. Para listar as branches remotas, use:

git branch -r

Para excluir uma branch remota, use:

git push origin --delete <nome-da-branch>

Em relação ao repositório remoto, o GitHub também oferece funcionalidades como pull requests, issues e wiki, que facilitam a colaboração e o gerenciamento de projetos. Para saber mais sobre essas funcionalidades, consulte a documentação do GitHub.

Pull Requests

Pull Requests (PRs) são uma funcionalidade do GitHub que permite colaborar em projetos de forma organizada. Eles são usados para propor alterações em um repositório, permitindo que outros revisem e discutam o código antes de mesclá-lo.

Para criar um Pull Request, siga os passos abaixo:

1. Faça as alterações no código em uma branch separada.
2. Envie a branch para o repositório remoto com o comando:

git push origin <nome-da-branch>

3. No GitHub, acesse o repositório e clique em "Pull Requests".
4. Clique em "New Pull Request" e selecione a branch que deseja mesclar.
5. Adicione uma descrição clara e envie o Pull Request.

Os revisores podem comentar, solicitar alterações ou aprovar o Pull Request. Após a aprovação, ele pode ser mesclado na branch desejada. Isso garante que as alterações sejam revisadas e conflitos sejam resolvidos antes de serem incorporadas ao código principal, evitando problemas e melhorando a qualidade do código.