Guia Básico de Git

O Git é uma ferramenta essencial para controle de versões em desenvolvimento de software. Ele permite que várias pessoas trabalhem simultaneamente em um projeto, rastreando todas as mudanças feitas no código de forma organizada e segura. Neste guia, vamos explorar como instalar o Git, configurar seu usuário, entender comandos básicos e trabalhar com outros colaboradores.

1. Instalação do Git

Antes de começar, você precisará instalar o Git no seu computador. O processo de instalação varia de acordo com o sistema operacional.

Windows:

Baixe o Git a partir do site oficial: https://git-scm.com.
Durante a instalação, mantenha as opções padrão selecionadas.

Linux (Debian/Ubuntu):

Abra o terminal e execute o comando:

sudo apt-get install git

macOS:

Instale o Git via Homebrew:

brew install git

Para verificar se o Git foi instalado corretamente, digite no terminal:

git --version

2. Configuração de Usuário no GitLab

Após a instalação do Git, você precisa configurar seu nome de usuário e e-mail para garantir que suas contribuições sejam corretamente atribuídas a você. O Git utiliza essas informações em todos os seus commits.

Execute os seguintes comandos no terminal, substituindo <seu_nome> e <seu_email> com seus dados:

git config --global user.name "<seu_nome>" git config --global user.email "<seu_email>"

Para se autenticar ao usar o GitLab, é recomendado configurar uma chave SSH. Isso facilita o processo de autenticação e elimina a necessidade de inserir sua senha em cada operação de push ou pull.

3. Comandos Básicos do Git

Aqui estão os principais comandos do Git que você usará no dia a dia.

Clone

Baixa uma cópia de um repositório remoto (ex.: GitLab) para o seu computador. - Comando: git clone <URL_do_repositorio> - Exemplo: git clone https://gitlab.com/seuprojeto.git

Add

Adiciona arquivos para o "estágio", preparando-os para o commit. - Comando: git add <nome_do_arquivo> ou git add . para adicionar todos os arquivos modificados. - Exemplo: git add index.html

Commit

Cria um ponto de salvamento com as mudanças feitas nos arquivos que foram adicionados com o git add. - Comando: git commit -m "Descrição do que foi alterado" - Exemplo: git commit -m "Corrige bug na página de login"

Push

Envia os commits do seu repositório local para o repositório remoto (ex.: GitLab). - Comando: git push - Exemplo: git push origin main

Pull

Baixa as mudanças mais recentes do repositório remoto para o seu repositório local. - Comando: git pull - Exemplo: git pull origin main

Branch

Branches são ramificações que permitem o trabalho em paralelo. É ideal para desenvolver novas funcionalidades sem afetar o código principal. - Criar um branch: git branch <nome_do_branch> - Mudar para outro branch: git checkout <nome_do_branch> - Exemplo: git branch nova_funcionalidade

Status

Mostra o estado atual do repositório local, indicando quais arquivos foram modificados, adicionados ou estão prontos para commit. - Comando: git status

Log

Mostra o histórico de commits feitos no projeto. - Comando: git log

Checkout

Permite mudar para outro branch ou restaurar arquivos para uma versão anterior. - Comando: git checkout <nome_do_branch> ou git checkout <commit_id> - Exemplo: git checkout develop

4. Colaboração em Projetos

Quando você trabalha com outras pessoas, é essencial manter um fluxo de trabalho organizado. Aqui estão algumas práticas comuns:

Fluxo de Trabalho Básico:

Criar uma branch para cada nova funcionalidade ou correção de bug que você for desenvolver.
git checkout -b nome_da_branch
Fazer commits regularmente na branch.
git add . seguido de git commit -m "mensagem descritiva"
Fazer pull da branch principal antes de enviar suas mudanças para o repositório remoto.
git pull origin main
Resolver conflitos, caso existam.
Enviar suas mudanças com o git push.
git push origin nome_do_branch
Criar um merge request no GitLab para que suas mudanças possam ser revisadas e integradas ao projeto principal.

5. Lidando com Conflitos

Conflitos ocorrem quando duas ou mais pessoas modificam a mesma parte do código em suas branches. O Git avisa sobre esses conflitos ao tentar fazer um merge ou pull.

Como Resolver Conflitos:

Após receber uma mensagem de conflito, abra os arquivos com conflitos.

O Git indicará as áreas conflitantes com marcas como:

<<<<<<< HEAD
Código que você alterou.
=======
Código alterado por outro colaborador.
>>>>>>> branch_remoto

Escolha qual código manter ou combine as duas versões.
Após resolver, marque o conflito como resolvido:
git add <arquivo_resolvido>
Finalize o processo com um commit:
git commit -m "Resolve conflito no arquivo <nome_do_arquivo>"

6. Iniciando uma Contribuição

Para iniciar sua contribuição em um projeto GitLab (ou outro repositório Git): 1. Clone o repositório na sua máquina: - git clone <URL_do_repositorio> 2. Crie um branch para sua contribuição. 3. Faça suas mudanças e siga o fluxo de trabalho descrito acima. 4. Ao terminar, crie um Merge Request no repositório original para revisão e integração.

Com este guia, você tem uma visão geral dos principais comandos e práticas para trabalhar com Git. Esta ferramenta é extremamente poderosa para colaboração, e dominar seu uso é essencial para quem desenvolve software em equipe.

Tabela de versionamento

Versão	Data	Descrição	Responsável
1.0	29/10/2024	Criação do trecho de Principais Comandos do GIT	Arthur José
2.0	29/10/2024	Adicionando tópicos de 1 a 6 e explicando mais os comandos GIT	João Henrique
3.0	29/10/2024	Pequenas Mudancas no documento do acima	Arthur José