Edição atual tal como às 10h26min de 20 de maio de 2026 (ver código-fonte) Guilherme (Discussão | contribs) (Created page with "= Guia Completo: Utilizando Git e GitHub do Zero = Bem-vindo(a) ao guia de uso básico do Git e GitHub! Este tutorial foi escrito para quem nunca teve contato com a ferrament...")

(Sem diferença)

---

Edição atual tal como às 10h26min de 20 de maio de 2026

Guia Completo: Utilizando Git e GitHub do Zero

Bem-vindo(a) ao guia de uso básico do Git e GitHub! Este tutorial foi escrito para quem nunca teve contato com a ferramenta. O Git é um sistema de controle de versão (como uma máquina do tempo para o seu código), e o GitHub é um site onde você guarda esse código na nuvem.

Neste tutorial, vamos cobrir o ciclo completo: pegar um código que já existe no seu servidor, colocar no GitHub, baixar no seu computador para editar, salvar as alterações e atualizar o servidor novamente.

Pré-requisitos

• Ter uma conta criada no GitHub.
• Ter o Git instalado no servidor e no seu computador.
• Saber abrir o Terminal (Linux/Mac) ou o Prompt de Comando/PowerShell (Windows).

---

Passo Zero: Protegendo suas Senhas (O arquivo .gitignore)

MUITO IMPORTANTE: Antes de enviarmos seu código do servidor para o GitHub, precisamos garantir que arquivos com senhas de banco de dados não sejam enviados. Se você enviar uma senha para um repositório público, qualquer pessoa na internet poderá ver!

Para isso, usamos um arquivo chamado .gitignore. Ele diz ao Git: "Ignore estes arquivos, não os envie para a nuvem".

1. Acesse a pasta do seu projeto no servidor através do terminal.
2. Crie um arquivo chamado .gitignore (com o ponto no início).
3. Dentro dele, escreva o nome do arquivo que contém as suas senhas.

Por exemplo, se as suas configurações de banco de dados estão em um arquivo chamado config.php ou .env, você criaria e editaria o arquivo assim:

nano .gitignore

Dentro do arquivo, adicione a linha com o nome do arquivo a ser ignorado:

config.php

Salve e feche o arquivo. O Git agora fingirá que o config.php não existe!

Situação 1: Do Servidor para o GitHub

Você tem o sistema rodando no servidor e quer guardar esse código no GitHub.

1. Crie um Repositório no GitHub

Entre no site do GitHub e clique no botão verde "New" (Novo repositório). Dê um nome ao seu projeto (ex: meu-sistema). Escolha a visibilidade:

1. • Public (Público): Qualquer um na internet pode ver seu código.
   • Private (Privado): Apenas você e quem você convidar podem ver. (Recomendado para sistemas de empresas).

NÃO marque as opções "Add a README file" ou "Add .gitignore". Deixe o repositório totalmente vazio. Clique em Create repository.

2. Envie o código do Servidor

No terminal do seu servidor, navegue até a pasta onde estão os arquivos do seu sistema e digite os comandos abaixo, um por um: Inicia o Git na pasta do servidor:

git init

Adiciona todos os arquivos (menos os que estão no .gitignore) para serem salvos:

git add .

Cria um "pacote" com esses arquivos e dá uma mensagem a ele (isso se chama commit):

git commit -m "Primeiro envio do sistema"

Muda o nome da ramificação principal para "main" (padrão atual do GitHub):

git branch -M main

Conecta a sua pasta local ao repositório que você criou no GitHub (Substitua a URL abaixo pela URL do seu repositório no GitHub):

git remote add origin https://github.com/SEU_USUARIO/NOME_DO_REPOSITORIO.git

Envia (push) o código para o GitHub:

git push -u origin main

Atenção para Repositórios Privados: Ao fazer o comando git push, o GitHub pedirá seu usuário e senha. Hoje em dia, a "senha" não é a senha do site, mas sim um Personal Access Token (PAT). Vá no GitHub > Settings (Configurações) > Developer settings > Personal access tokens > Tokens (classic). Gere um novo token marcando a caixinha "repo", copie esse código gigante e cole no terminal quando pedir a senha.

Situação 2: Do GitHub para o seu Computador Local

Agora que o código está seguro no GitHub, você quer baixá-lo no seu computador para trabalhar usando o VSCode (ou Google Antigravity/ambiente web). Abra o seu terminal no computador local e navegue até a pasta onde deseja salvar o projeto. Digite o comando de "clonar" (copiar):

git clone https://github.com/SEU_USUARIO/NOME_DO_REPOSITORIO.git

O Git criará uma pasta com o nome do seu projeto. Abra o VSCode, clique em File > Open Folder e selecione essa nova pasta. Nota: Se o repositório for Privado, o VSCode ou o terminal abrirá uma janelinha do navegador pedindo para você autorizar o acesso à sua conta do GitHub. É só clicar em autorizar. Importante: Como você ignorou o arquivo de senha (ex: config.php) na Situação 1, ele não virá para o seu computador. Você precisará criar um config.php localmente com as senhas do seu banco de dados de teste (local).

Situação 3: Atualizando o repositório após alterações locais

Você trabalhou no seu computador, modificou arquivos, criou novas funcionalidades no VSCode e agora quer mandar essas novidades de volta para o GitHub. No terminal do seu computador (pode usar o terminal integrado do próprio VSCode), digite: Adiciona todas as modificações que você fez:

git add .

Salva essas alterações com uma mensagem descrevendo o que foi feito:

git commit -m "Adicionada tela de login e corrigido bug de layout"

Envia as alterações para o GitHub:

git push

Pronto! Se você entrar no site do GitHub agora, verá que seus arquivos foram atualizados.

Situação 4: Atualizando o código no Servidor

O GitHub já tem o código novo, mas o seu servidor (Situação 1) ainda está rodando o código antigo. Vamos puxar as novidades do GitHub para o servidor. Acesse o terminal do seu servidor. Vá para a pasta do seu sistema. Digite o comando de "puxar" (pull):

git pull origin main

O Git irá baixar apenas os arquivos que foram modificados e atualizar seu sistema automaticamente! Como nós protegemos o arquivo de senhas com o .gitignore no passo zero, o comando git pull não vai apagar ou sobrescrever as senhas do banco de dados de produção do seu servidor.

Resumo do Ciclo de Trabalho Diário

Daqui em diante, seu fluxo de trabalho sempre será este: Trabalhar no Computador: git add . -> git commit -m "mensagem" -> git push Atualizar o Servidor: git pull origin main