Configuração do Git

Aliases, hooks e padrões sensatos do Git para equipes Python que usam uv, ruff e pytest localmente e em CI.

Receita

git config --global user.name "Ada Lovelace"
git config --global user.email "ada@acme.com"
git config --global pull.rebase true
git config --global fetch.prune true
git config --global alias.lg "log --oneline --graph -20"

Quando usar isso:

• Configuração de novo laptop para desenvolvedores
• Padronização do comportamento do git da equipe por meio de documentação + configuração de modelo
• Adição de hooks pre-commit que correspondem às GitHub Actions
• Habilitação de assinatura de commit ou assinaturas GPG/SSH

Exemplo de Trabalho

# ~/.gitconfig (excerto)
[user]
    name = Ada Lovelace
    email = ada@acme.com
[pull]
    rebase = true
[fetch]
    prune = true
[init]
    defaultBranch = main
[alias]
    st = status -sb
    sync = "!git fetch origin && git rebase origin/main"
    cleanup = "!git branch --merged main | grep -v main | xargs git branch -d"

# .pre-commit-config.yaml (repositório)
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.9.0
    hooks:
      - id: ruff
      - id: ruff-format
  - repo: local
    hooks:
      - id: pytest-quick
        name: pytest quick
        entry: uv run pytest -q tests/unit
        language: system
        pass_filenames: false

O que isso demonstra:

• Identidade global e padrões de rebase-on-pull
• Aliases curtos para sincronização diária
• pre-commit espelha linting de CI e testes unitários rápidos
• defaultBranch = main para novos repositórios

Análise Profunda

Como Funciona

• Níveis de configuração - system < global < local < worktree; local substitui global por repositório.
• Hooks - Scripts em .git/hooks/ ou gerenciados pelo framework pre-commit.
• Atributos - .gitattributes para nbstripout, LFS, gerado pelo linguist.
• Assinatura - Assinatura de commit SSH (gpg.format ssh) no Git moderno.

Configurações Recomendadas

Notas Python

# Identidade local do repositório para laptop de trabalho
git config user.email "ada@acme.com"
 
# Garante que os hooks sejam executados
uv run pre-commit install
uv run pre-commit run --all-files

Armadilhas

• Hooks globais bloqueando commits WIP - Pytest completo a cada commit atrasa o fluxo. Correção: subconjunto rápido de unidades localmente; suite completa em CI.
• Surpresa do autoStash - Entradas de stash ocultas após o rebase. Correção: higiene do git stash list.
• Email errado nos commits - Quebra o CLA e a auditoria. Correção: git config user.email por repositório para contratados.
• Pular hooks com --no-verify - Ignora ruff em commit de emergência. Correção: permitir apenas em caso de quebra; corrigir antes de mesclar.
• Finais de linha do Windows - CRLF misturado falha o ruff. Correção: .gitattributes * text=auto eol=lf.
• Assinatura de commit mal configurada - Pushes rejeitados. Correção: testar git commit -S -m "test" em um branch primeiro.

Alternativas

FAQs

Relacionados

• Comandos Essenciais do Git - comandos que os aliases envolvem
• Git para Dados/Notebooks - atributos nbstripout
• Linting e Formatação - ruff em hooks
• Lista de Verificação de Configuração de Ambiente - configuração de novo dev

Versões da Stack: Esta página foi escrita para Python 3.14.0 (estável 3.14, manutenção 3.13), FastAPI 0.115+, Django 5.2, Flask 3.1, Pydantic 2, PyTorch 2.6+, pandas 2.2+, Polars 1.x, ruff 0.9+ e uv 0.6+.