1.
3. 🌐 → 🖥️ Sincronizando repositório LOCAL com conteúdo do repositório REMOTO do GitHub (pull)
4. 🖥️ → 🌐 Sincronizando repositório REMOTO do GitHub com conteúdo do repositório LOCAL (push)
5. 🛠️ Gestão de repositório (add, branches e commits)
6. 🆘 Resolução de conflitos (erros comuns)
-
O comando "git clone" serve para clonar todo o repositório remoto diretamente na sua máquina, isso fará com que seja criado um arquivo oculto ".git" na pasta local onde vc irá clonar o repositório e você poderá começar a gerenciar o repositório localmente. É bem simples a execução do comando e ocorre da seguinte forma:
git clone <URLdoRepositório>-
Exemplo prático:
git clone https://github.com/pedroaugustorgg/EstudoGit
-
⚙️ Como setar seu usuário e e-mail do GitHub localmente para trabalhar com repositórios remotos (só precisa fazer uma vez):
-
git config --global user.name <NomeDoUsuário>-
Exemplo prático:
git config --global user.name "Pedro Guedes"
-
-
git config --global user.email <E-mailDoUsuário>-
Exemplo prático:
git config --global user.email [email protected]
-
-
git config user.name && git config user.email⚠️ Observação: Caso você tenha setado o usuário e/ou e-mail errado, basta ir na pasta oculta ".git" do seu repositório e alterar o arquivo "config", lá estará o seu usuário e senha setados anteriormente.
-
Caso seu usuário e e-mail já esteja setado no repositório local, para importar o conteúdo do GitHub para sua máquina, basta utilizar o seguinte comando:
git pull -
Caso o repositório local ainda não esteja sincronizado, você precisará informar a URL do repositório que deseja:
git pull <remoteURL>-
Exemplo prático:
git pull https://github.com/pedroaugustorgg/EstudoGit
-
-
-
O rebase é um método comum para importar alterações do repositório remoto para o repositório local (mais detalhes clicando aqui), porém descartando alterações locais não sincronizadas.
-
Para melhor entendimento, vamos imaginar um cenário prático: Em um cenário hipotético onde o desenvolvedor precisa corrigir um bug que está em produção, o rebase poderia ser utilizado para sincronizar uma branch de desenvolvimento com uma branch já em produção exatamente como ela se encontra remotamente. Segue um exemplo prático de uma sincronia da branch "developer" local com a branch "main" remota:
git checkout developer git rebase main
-
-
💡 Dica valiosa: Para recuperar todas as alterações do repositório remoto e, em seguida, reorganizar o histórico de commits local, movendo os commits locais para frente na árvore de commits, após os commits recuperados do repositório remoto. Utilize o seguinte comando:
git pull –-rebase⚠️ Importante: O rebase irá REFAZER suas branches locais de acordo com as branches remotas, ou seja, se houverem alterações realizadas localmente (ou até mesmo commits), estas serão desfeitas.
-
-
Com todos os commits devidamente realizados, você pode enviar tudo o que você fez localmente para atualizar o repositório remoto com o seguinte comando:
git push <remoteURL> <NomeDaBranch>-
Exemplo prático: Sincronizando todo o trabalho local com a branch "DevPedro" do repositório remoto.
git push https://github.com/pedroaugustorgg/EstudoGit DevPedro
-
-
💡 Dica valiosa¹: Para sincronizar todas as branches locais com as branches remotas (sem a necessidade de validar pull request no GitHub), basta utilizar o seguinte comando:
git push --all -
💡 Dica valiosa²: Para sincronizar uma branch específica diretamente na branch remota (sem a necessidade de validar pull request no GitHub), deve-se utilizar o seguinte comando:
git push --set-upstream origin <NomeBranchRemota>⚠️ Observação.: NÃO irá funcionar caso seja o primeiro push da máquina local para o repositório remoto.
-
O comando "git add" serve para adicionar os arquivos com alterações realizadas no repositório dentro do commit a ser realizado posteriormente. Segue um exemplo prático:
git add index.html-
💡 Dica valiosa: Para que não haja a necessidade de ir adicionando os arquivos tratados um a um, você pode utilizar o seguinte comando que irá adicionar todas as alterações realizadas:
git add .
-
-
As branches são basicamente os "setores" dentro do mesmo repositório que podem ser utilizadas de forma simultânea e paralela ao setor/branch principal, que geramente é chamada de main ou master por padrão, porém pode ser qualquer nome que o dono do respositório queira chamar. Para visualizar as branches continas no repositório local, você pode utilizar o seguinte comando:
git branch-
Para CRIAR uma branch, o seguinte comando deve ser executado:
git branch <NomeDaBranch>-
💡 Dica valiosa¹: Para criar uma nova branch e já trocar para ela, basta utilizar o comando -b, ficando da seguinte forma:
git branch -b <NomeNovaBranch> -
💡 Dica valiosa²: Para criar uma nova branch baseada em outra e já trocar para ela, utilize o seguinte comando:
git branch -b <NomeNovaBranch> <NomeBranchRemota>-
Exemplo:
git branch -b CorrecaoBug main
-
-
-
Para REMOVER uma branch localmente, os seguintes comandos devem ser executados:
-
Removendo uma branch localmente:
git branch -d <NomeDaBranch> -
Removendo uma branch remotamente:
git push origin --delete fix/authentication-
💡 Dica valiosa: Para sincronizar sua lista de branches após remover branch(es) remotas, o seguinte comando precisará ser executado:
git fetch -p
-
-
-
Para TROCAR de branch no respositório, o seguinte comando deve ser executado:
git checkout <NomeDaBranch>-
💡 Baixando uma branch remota para edição localmente:
git checkout -b DevPedro origin/DevPedro
-
-
Para MERGEAR (mesclar) uma branch com a outra, o seguinte comando deve ser executado:
git checkout main git merge DevPedro⚠️ Observação.: Para realizar o merge, é necessário estar na branch que deverá receber as alterações. Neste caso acima, a branch "main" será mesclada com os conteúdos da branch "DevPedro"
-
-
O commit serve para como um "registro" de todas as tratativas realizadas no repositório em questão (seja ajuste em linhas de código ou até mesmo adição/exclusão de arquivos) desde a última sincronia realizada.
git commit -m "Título do commit" -m "descrição do commit"-
💡 Dica valiosa: A sequencia de comandos mais comum para verificar os arquivos editados, salvar todas as suas alterações locais em um commit e mesclar com a branch principal do repositório (main ou master) é a seguinte:
git status git add . git commit -m "Título do commit" -m "descrição do commit" git checkout main git merge <branch_com_alteracoes>
-
-
- Problema: Repositório local não sincronizado com repositório online e pode ocorrer durante um push.
- Exemplo prático do erro:
-
! [rejected] main -> main (non-fast-forward)
-
- Link com solução ✅ A dica é realizar uma sincronia do repositório remoto com o seu repositório local através do comando "git pull", refazer as alterações que vc precisa e, daí sim, realizar o push posteriormente.
-
Exemplo de solução genérica:
git pull origin <NomeBranchLocal> git add . git commit -m "TítuloDoCommit" -m "Descrição + Resolução de conflito na atualização de repositório local"
-
- 💡 Dica valiosa: Caso não esteja conseguindo fazer o "git pull", você pode tentar um rebase (levando em consideração que todas as alterações locais serão perdidas).
-
- Problema: Divergência de match entre as branches, também pode ocorrer ao fazer um push do repositório local para o remoto.
- Exemplo prático do erro:
-
error: src refspec main does not match any
error: failed to push some refs to <URLdaBranch>
-
- Link com solução ✅ A dica é verificar se o primeiro commit localmente do repositório já foi realizado. Caso ainda não tenha sido realizado, o primeiro commit deve ser feito e logo em seguida será possível realizar o push para a branch remota desejada com o comando "git push origin <NomeBranchRemota>".
-
Exemplo de solução genérica:
git commit -m "Título do commit" -m "Descrição + Resolução de conflito no match entre branches" git push origin main
-
-
- Problema: Ocorre durante um merge entre branches. Como o merge automático é feito em arquivos textos que não sofreram alterações nas mesmas linhas, o merge manual precisa ser feito em arquivos textos que sofreram alterações nas mesmas linhas. Caso não seja feito, isso resultará em um conflito.
- Exemplo prático do erro:
-
Automerging <NomeDoArquivo.txt>
CONFLICT (content): Merge conflict in meu_arquivo.txt
Automatic merge failed; fix conflicts and then commit the result.
-
- Link com solução ✅ A dica é adicionar os arquivos com o comando "git add <nome_do_arquivo>" ou "git add .", commitar as alterações já adicionadas e realizar o merge posteriormente.
-
Exemplo de solução genérica:
git checkout <NomeBranchAlterada> git add . git commit -m "TítuloDoCommit" -m "Descrição + Resolução de conflito no merge" git checkout main git merge <NomeBranchAlterada>
-
-
- Problema: Normalmente ocorre quando você tenta realizar um pull (puxar conteúdo do repositório remoto para o local) e existe alguma alteração no seu repositório local que precisa ser desfeita ou commitada para ser possível seguir com o pull.
- Exemplo prático do erro:
-
error: Pulling is not possible because you have unmerged files.
hint: Fix them up in the work tree, and then use 'git add/rm <file>'
hint: as appropriate to mark resolution and make a commit.
fatal: Exiting because of an unresolved conflict.
-
- Link com solução ✅ A dica pra solucionar esta intercorrência é conferir alterações ainda não commitadas com o comando "git status" e realizar o commit ou desfazer alguma alteração com o comando "git checkout <arquivo.txt>".
-
Exemplo de solução genérica:
git add . git commit -m "TítuloDoCommit" -m "Descrição + Resolução de conflito no pull" git pull origin main
-
- 💡 Dica valiosa: Para desfazer TODAS as alterações locais NÃO COMITADAS você pode usar o comando "git reset --hard HEAD".
Repositório de apoio/inspiração: leocomelli/git.md