Introdução ao Git: Inicializando e Clonando Repositórios

Inicializar e clonar repositórios são as duas maneiras básicas de começar a trabalhar com Git. Você transforma uma pasta existente em um repositório Git ou copia um repositório existente para trabalhar com seus arquivos e histórico.

Esses comandos parecem simples, mas as escolhas que você faz no início afetam remotos, branches, arquivos ignorados e fluxos de trabalho em equipe. Uma configuração limpa evita confusões mais tarde.

O que um Repositório Git Contém

Um repositório Git é uma pasta de projeto com um diretório .git oculto dentro dela. Esse diretório .git armazena o histórico de commits, referências de branches, informações de remotos, configuração e o banco de dados interno de objetos do Git.

Normalmente, você não edita arquivos .git manualmente. Você usa comandos Git, e o Git atualiza esses dados internos para você.

Para verificar se uma pasta já é um repositório, execute:

git status

Se o Git disser que a pasta não é um repositório, você pode inicializar um. Se mostrar um branch, arquivos alterados ou uma árvore de trabalho limpa, o Git já está rastreando essa pasta.

Ajuda entender três áreas comuns:

• Árvore de trabalho: os arquivos que você pode ver e editar.
• Área de staging: as alterações selecionadas para o próximo commit.
• Histórico do repositório: os commits que o Git já registrou.

Ao inicializar ou clonar um repositório, o Git configura essas partes para que você possa começar a fazer commits.

Inicializando um Novo Repositório

Use git init quando você tem uma pasta de projeto local que ainda não é rastreada pelo Git.

Crie uma pasta e inicialize-a:

mkdir my-app
cd my-app
git init

O Git cria o diretório .git oculto. Agora você pode adicionar arquivos e fazer seu primeiro commit:

echo "# My App" > README.md
git add README.md
git commit -m "Adicionar README"

Se o seu branch padrão deve ser nomeado main, você pode definir isso globalmente antes de criar novos repositórios:

git config --global init.defaultBranch main

Ou renomeie o branch atual após a inicialização:

git branch -M main

Para um projeto real, crie um .gitignore antes do seu primeiro commit amplo. Isso impede que pastas de dependências, saídas de build, logs e segredos locais entrem no histórico:

node_modules/
dist/
.env
*.log

Depois que um arquivo é commitado, adicioná-lo ao .gitignore posteriormente não o remove do histórico. É por isso que as regras de ignorar no início são importantes.

Se você planeja publicar o repositório em um serviço de hospedagem, crie o repositório remoto vazio lá primeiro e depois conecte-o:

git remote add origin [email protected]:exemplo/my-app.git
git push -u origin main

A opção -u define o rastreamento upstream. Depois disso, git push e git pull simples sabem qual branch remoto usar.

Clonando um Repositório Existente

Use git clone quando um repositório já existe em outro lugar. Clonar copia os arquivos do projeto, o histórico e a configuração remota.

O comando básico é:

git clone [email protected]:exemplo/my-app.git

O Git cria uma pasta com o nome do repositório. Para escolher um nome de pasta local diferente, adicione-o no final:

git clone [email protected]:exemplo/my-app.git worktree-app

Após clonar, entre na pasta e inspecione-a:

cd worktree-app
git status
git remote -v
git branch

Por padrão, o remoto geralmente é nomeado origin. Esse nome é convencional, não mágico. Ele aponta para a URL que o Git usará para buscas e envios.

Você pode ver URLs de clone HTTPS ou SSH. HTTPS é fácil de começar, especialmente para repositórios públicos. SSH é comum para desenvolvimento diário porque usa chaves e evita prompts de senha repetidos quando configurado corretamente.

Para um repositório grande, você pode usar um clone raso:

git clone --depth 1 https://exemplo.com/repo.git

Isso baixa apenas o histórico recente. É útil para trabalhos de CI ou inspeção rápida, mas pode limitar comandos que precisam de commits mais antigos, tags ou histórico completo. Para desenvolvimento normal, um clone completo geralmente é melhor.

Se o repositório usa submódulos, clone com:

git clone --recurse-submodules [email protected]:exemplo/platform.git

Ou inicialize-os após clonar:

git submodule update --init --recursive

Submódulos adicionam outra camada de gerenciamento de repositório, então leia a documentação de configuração do projeto antes de fazer alterações.

Verificações Comuns Após a Configuração

Após inicializar ou clonar, execute algumas verificações antes de começar a codificar. Elas ajudam a detectar configurações incorretas cedo.

Verifique sua identidade:

git config user.name
git config user.email

Se este é um repositório de trabalho, certifique-se de que o email corresponde à sua conta da empresa. Você pode defini-lo localmente:

git config --local user.email "[email protected]"

Verifique os remotos:

git remote -v

Certifique-se de que as URLs de fetch e push apontam para o repositório esperado. Enviar acidentalmente para um fork ou espelho pessoal pode perder tempo.

Verifique o branch atual:

git branch --show-current

Se você clonou um repositório, leia o README ou guia de contribuição antes de criar um branch. Muitas equipes esperam nomes de branch como feature/ticket-123-descricao-curta ou fix/login-timeout.

Antes do seu primeiro commit, verifique os arquivos ignorados:

git status --ignored

Esta é uma maneira rápida de confirmar que artefatos de build e arquivos de segredo locais não serão commitados.

Quando Pedir Ajuda

Peça ajuda a um colega de equipe ou mantenedor do repositório se você não tiver certeza de qual URL remota usar, se deve clonar um fork ou o repositório principal, ou como os submódulos devem ser tratados.

Você também deve parar se inicializou o Git no diretório errado. Por exemplo, executar git init na sua pasta home pode fazer o Git ver milhares de arquivos não relacionados. Não comece a deletar coisas aleatoriamente. Confirme onde .git foi criado e remova apenas os metadados do repositório equivocado se tiver certeza de que não contém histórico necessário.

Começar com Git é principalmente sobre hábitos limpos. Use git init para novos projetos locais, git clone para repositórios existentes e verifique seu branch, remoto, identidade e arquivos ignorados antes de começar o trabalho sério.