Referências

Documentação Oficial

Git

Documentação oficial do Git — referência completa de todos os comandos
Pro Git Book — livro gratuito disponível em português
Git Cheat Sheet — folha de referência rápida em português

GitHub

GitHub Docs — documentação oficial do GitHub em português
GitHub Skills — cursos interativos gratuitos
GitHub Desktop Documentation — guia do GitHub Desktop

Positron

Positron Documentation — documentação oficial do Positron
Git Version Control no Positron — guia específico de Git no Positron

Tutoriais Interativos

Learn Git Branching: Tutorial visual e interativo para aprender Git, disponível em português. Excelente para entender branches e merge.
Oh My Git!: Jogo para aprender Git de forma divertida.
Git Immersion: Tutorial guiado com exercícios práticos.

Para Usuários de R

Happy Git and GitHub for the useR: Guia completo de Jenny Bryan para usuários de R. Cobre desde a instalação até fluxos avançados de trabalho.
R Packages: Git and GitHub: Capítulo do livro R Packages sobre uso de Git em desenvolvimento de pacotes.

Vídeos

Git e GitHub para Iniciantes — diversos tutoriais em português no YouTube
Curso de Git e GitHub - Curso em Vídeo — curso gratuito completo

Glossário

Repositório (repository): Pasta que contém seu projeto e todo o histórico de versões. Pode ser local (no seu computador) ou remoto (no GitHub).
Commit: Um “snapshot” do seu projeto em um momento específico. Cada commit tem uma mensagem descritiva e um identificador único (hash).
Branch: Uma linha independente de desenvolvimento. Permite trabalhar em funcionalidades separadas sem afetar o código principal.
Merge: Combinar alterações de uma branch em outra.
Push: Enviar commits locais para o repositório remoto (GitHub).
Pull: Baixar alterações do repositório remoto para o local.
Clone: Criar uma cópia local de um repositório remoto.
Fork: Criar uma cópia de um repositório de outra pessoa na sua conta GitHub.
Pull Request (PR): Solicitação para incorporar suas alterações em um repositório. Usado para revisão de código e colaboração.
Staging Area: Área intermediária onde você seleciona quais alterações incluir no próximo commit.
HEAD: Referência ao commit atual em que você está trabalhando.
Origin: Nome padrão dado ao repositório remoto principal.
Main/Master: Nome da branch principal do repositório.

Comandos Rápidos

Configuração

git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"
git config --list

Básicos

git init                    # Inicializar repositório
git clone URL               # Clonar repositório
git status                  # Ver status
git add .                   # Adicionar todos os arquivos
git commit -m "mensagem"    # Fazer commit
git push                    # Enviar para remoto
git pull                    # Baixar do remoto

Branches

git branch                  # Listar branches
git branch nome             # Criar branch
git checkout nome           # Trocar de branch
git checkout -b nome        # Criar e trocar
git merge nome              # Mesclar branch
git branch -d nome          # Deletar branch

Histórico

git log                     # Ver histórico
git log --oneline           # Histórico resumido
git diff                    # Ver alterações
git show HASH               # Ver commit específico

Desfazer

git checkout -- arquivo     # Descartar alterações
git reset arquivo           # Remover do staging
git reset --soft HEAD~1     # Desfazer último commit
git revert HASH             # Reverter commit

Arquivos Importantes

.gitignore

Arquivo que lista padrões de arquivos a serem ignorados pelo Git:

# Sistema operacional
.DS_Store
Thumbs.db

# R
.Rproj.user/
.Rhistory
.RData

# Python
__pycache__/
*.pyc
.venv/

# Dados sensíveis
*.csv
*.xlsx
senhas.txt

# IDEs
.vscode/
.idea/

README.md

Arquivo de apresentação do projeto. Deve conter:

Nome e descrição do projeto
Como instalar/configurar
Como usar
Como contribuir
Licença

Fluxo de Trabalho Recomendado

flowchart TD
    A[Criar branch] --> B[Fazer alterações]
    B --> C[git add .]
    C --> D[git commit]
    D --> E{Mais alterações?}
    E -->|Sim| B
    E -->|Não| F[git push]
    F --> G[Criar Pull Request]
    G --> H[Revisão]
    H --> I[Merge]
    I --> J[Deletar branch]

Problemas Comuns

“Permission denied” ao fazer push

Verifique se você está autenticado. Use token de acesso pessoal ou configure chave SSH.

“Your branch is behind”

Execute git pull para baixar as alterações do remoto antes de fazer push.

Conflitos de merge

Abra os arquivos conflitantes, resolva manualmente, depois:

git add arquivo-resolvido
git commit -m "Resolve conflitos"

Commit na branch errada

git reset --soft HEAD~1     # Desfaz commit, mantém alterações
git checkout branch-correta
git add .
git commit -m "mensagem"

Continue aprendendo!

Git é uma ferramenta poderosa e há sempre mais para aprender. Comece com o básico, pratique regularmente, e vá explorando recursos avançados conforme a necessidade surgir.