Melhores práticas do Git
-
Repositório: uma pasta que salva todas as alterações feitas nos arquivos em seu projeto.
-
Commit: um snapshot do projeto em um determinado momento.
-
Branch: uma cópia do projeto em que você pode trabalhar em um conjunto de alterações.
-
Pull request: uma solicitação para mesclar as alterações de um branch em outro.
Faça Commits com frequência
Faça commits pequenos e frequentes para registrar seu progresso.
Isso torna mais fácil rastrear alterações e encontrar bugs.
git add .
git commit -m "Descrição breve das alterações realizadas!"
Escreva mensagens claras de commit
Use mensagens descritivas que expliquem por que uma alteração foi feita, e não apenas o que mudou.
Boas mensagens de commit ajudam você e sua equipe a entender a história do projeto.
Seja específico: diga o quê e por quê, não apenas “Atualizar” ou “Consertar”. Use o modo imperativo: por exemplo, "Adicionar validação de login" em vez de "Adicionado a validação de login".
git commit -m "Mensagens clara que explica por que uma alteração foi feita!"
Use Branches
Crie Branches para recursos, correções e experimentos para manter seu Branch principal estável.
Dessa forma, você pode trabalhar em novas ideias sem afetar a base de código principal.
Por que? As Branches permitem testar e desenvolver de forma independente e tornar a colaboração mais segura. Nomeie as Branches claramente: por exemplo, feature/login-form ou bugfix/user-auth.
git checkout -b feature/login-form
Efetuar Pull antes de Push
Obtenha as alterações realizadas antes de enviar a sua alteração.
Isso atualiza seu branch local com alterações de outras pessoas, ajuda a evitar conflitos e garante que seu push seja bem-sucedido.
Por que? Se outra pessoa tiver enviado alterações desde seu último pull, seu push poderá ser rejeitado ou causar conflitos.
Puxar primeiro permite corrigir quaisquer problemas localmente.
git pull origin main
git push origin main
Revise as alterações antes de fazer o commit
Revise as alterações antes de fazer o commit Use git status e git diff para revisar suas alterações antes de fazer o commit.
Isso ajuda você a detectar erros antecipadamente.
git status
git diff
Keep Repositories Small
Avoid adding large files or unnecessary dependencies.
This keeps your repository fast and easy to clone.
For large files (like videos or datasets), use Git LFS (Large File Storage) instead of adding them directly to your repo.
Use .gitignore
Exclude files that shouldn't be tracked (like build artifacts, log files, or secrets) by adding them to a .gitignore file.
Files already tracked by Git will remain in the repository until you remove them with git rm --cached <file>.
# .gitignore
node_modules/
*.log
.env
.gitignore only prevents new files from being tracked.
Tag Releases
Use tags to mark release points (like v1.0) so you can easily find and reference important versions.
This helps you keep track of your project's history and make it easier to roll back to previous versions if needed.
git tag v1.0
git push origin v1.0
Good Git habits make it easier for your team (and your future self) to understand and build on your work.