Git GitHub iniciantes: guia completo e passo a passo
Quer aprender Git e GitHub, mas não sabe por onde começar? Este guia completo para iniciantes explica os conceitos, os comandos essenciais e o passo a passo para versionar seus projetos e colaborar com outros desenvolvedores.
Quer aprender Git e GitHub, mas não sabe por onde começar? Este guia completo para iniciantes explica os conceitos, os comandos essenciais e o passo a passo para versionar seus projetos e colaborar com outros desenvolvedores.
Se você está começando na programação, já deve ter ouvido falar de Git e GitHub. Eles são ferramentas essenciais para quem desenvolve software, e o melhor: são gratuitos. Este guia foi feito para você que nunca usou nada disso. Vamos direto ao ponto: ao final, você terá criado seu primeiro repositório no GitHub, feito um commit e entendido o fluxo básico de trabalho.
Pré-requisitos: um computador com acesso à internet, um editor de texto (como VS Code) e vontade de aprender. Não precisa saber programar.
Passo 1: Instalar o Git
O Git é o motor que roda tudo. Acesse o site oficial (git-scm.com) e baixe a versão para seu sistema operacional (Windows, macOS ou Linux). Durante a instalação no Windows, mantenha as opções padrão, elas já são boas para iniciantes. No macOS, você pode instalar via terminal com o comando xcode-select --install. Para Linux (Ubuntu/Debian), use sudo apt install git.
Dica: após instalar, abra o terminal (ou Git Bash no Windows) e digite git --version. Se aparecer um número (ex.: 2.43.0), deu certo.
Erro comum: pular a configuração inicial. O Git precisa saber quem você é para registrar os commits. Configure nome e e-mail com: git config --global user.name "Seu Nome" git config --global user.email "[email protected]"
Passo 2: Criar uma conta no GitHub
GitHub é a plataforma que hospeda seus repositórios na nuvem. Acesse github.com e clique em "Sign up". Escolha um nome de usuário, informe seu e-mail e crie uma senha. Você receberá um código de verificação no e-mail, insira-o e pronto.
Dica: o plano gratuito do GitHub já oferece repositórios ilimitados para projetos públicos e privados. Não precisa pagar nada.
Erro comum: confundir Git com GitHub. Git é o software de versionamento; GitHub é o serviço online que usa Git. Você pode usar Git sem GitHub, mas o GitHub facilita compartilhar seu código.
Passo 3: Criar seu primeiro repositório local
Um repositório é como uma pasta mágica que o Git "observa". Crie uma nova pasta no seu computador (ex.: meu-primeiro-repo) e abra o terminal nela. Dentro da pasta, digite: git init Isso inicializa um repositório Git vazio. Uma subpasta oculta .git é criada, é ali que o Git guarda todo o histórico.
Dica: você pode confirmar que deu certo com git status. A mensagem dirá que você está no branch main e que não há commits ainda.
Erro comum: esquecer de estar na pasta certa. Use cd para navegar até o diretório correto antes de digitar git init.
Passo 4: Adicionar e commitar arquivos
Crie um arquivo simples dentro da pasta, como index.html ou README.md. Escreva algo, por exemplo: "Olá, mundo!". Agora, no terminal, digite: git add . git commit -m "Primeiro commit: adiciona README" O comando git add . prepara todos os arquivos novos/modificados para o commit. O git commit tira um "instantâneo" do projeto com uma mensagem descritiva.
Dica: escreva mensagens de commit claras e no imperativo ("Adiciona", "Corrige", "Remove"). Isso ajuda você e outras pessoas a entenderem o histórico.
Erro comum: usar git commit sem o -m, isso abre um editor de texto (Vim) que pode confundir iniciantes. Sempre use a flag -m seguida da mensagem entre aspas.
Passo 5: Conectar ao GitHub e enviar o repositório
No GitHub, clique no botão "+" (canto superior direito) e escolha "New repository". Dê um nome (pode ser o mesmo da pasta local), deixe como público e não marque "Add a README" (já criamos um). Clique em "Create repository".
A página seguinte mostra comandos para conectar seu repositório local ao remoto. Copie e cole no terminal: git remote add origin https://github.com/seu-usuario/meu-primeiro-repo.git git branch -M main git push -u origin main Pronto! Seu código está no GitHub. Atualize a página do repositório no navegador e veja seus arquivos lá.
Dica: se aparecer um pedido de login, use um token de acesso pessoal (Personal Access Token) em vez de senha. No GitHub, vá em Settings > Developer settings > Personal access tokens > Tokens (classic) e crie um com escopo repo.
Erro comum: esquecer de criar o repositório no GitHub antes de tentar o git push. O comando git remote add só funciona se o repositório remoto já existir.
Checklist: o que você aprendeu
- [ ] Instalou e configurou o Git
- [ ] Criou conta no GitHub
- [ ] Inicializou um repositório local com
git init - [ ] Adicionou arquivos com
git adde criou um commit comgit commit - [ ] Conectou o repositório local ao GitHub e fez o primeiro
git push
Perguntas frequentes sobre Git e GitHub
Como posso aprender Git e GitHub?
Comece com este guia prático. Depois, pratique criando repositórios para projetos pessoais. A documentação oficial do Git (git-scm.com) e o "Hello World" do GitHub (docs.github.com) são ótimos recursos gratuitos.
O Git é gratuito?
Sim, Git é um software livre e de código aberto. Você pode baixar, usar e distribuir sem pagar nada. O GitHub também oferece um plano gratuito com recursos suficientes para iniciantes.
Como funciona o Git e o GitHub?
Git registra cada alteração nos seus arquivos como um "commit", formando um histórico. GitHub hospeda esse histórico online e permite que outras pessoas vejam, copiem (clone) e contribuam com o projeto via pull requests.
Quais são os comandos básicos do Git?
Os essenciais: git init (iniciar repositório), git add (preparar arquivos), git commit (salvar instantâneo), git push (enviar para GitHub), git pull (baixar atualizações) e git clone (copiar repositório remoto).
