Edição atual tal como às 10h16min de 2 de julho 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

Implantando o Sistema no Servidor do Zero

Se você formatou seu servidor, contratou uma hospedagem nova, ou simplesmente quer instalar o seu sistema em um servidor onde ele ainda não existe, você precisará "clonar" o código do GitHub.

Como o GitHub agora é a fonte oficial (a nuvem) do seu projeto, o processo é bem simples, mas exige um cuidado especial com os arquivos que ignoramos anteriormente.

Passo 1: Acessar a pasta destino no Servidor

Primeiro, você precisa acessar o terminal do seu servidor e navegar até a pasta pública onde o seu site ou sistema deve ficar rodando.

Geralmente, em servidores Linux (Apache/Nginx), essa pasta fica em lugares como /var/www/html.

Digite no terminal do servidor:

cd /caminho/para/a/pasta/do/seu/servidor

Passo 2: Clonar o Repositório

Agora vamos baixar o código do GitHub para essa pasta. Importante: Se você simplesmente usar o comando de clonar, o Git criará uma subpasta com o nome do seu repositório (ex: /var/www/html/meu-sistema). Se você quiser que os arquivos fiquem diretamente na pasta atual, você deve colocar um ponto (.) no final do comando. Certifique-se de que a pasta atual está totalmente vazia e digite:

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

(Não esqueça o espaço e o ponto no final se quiser instalar os arquivos soltos na pasta atual!)

E se o Repositório for Privado?

Se o seu repositório for Privado, o servidor não terá permissão para baixar os arquivos imediatamente. Ele pedirá seu "Username" (nome de usuário) e um "Password" (senha). Lembre-se: o GitHub não aceita mais a senha do site no terminal. Você precisará gerar um Personal Access Token (PAT): Vá no GitHub > Settings (Configurações) > Developer settings > Personal access tokens > Tokens (classic). Clique em "Generate new token". Dê um nome (ex: "Acesso Servidor"), defina a validade e marque a caixinha repo. Copie o código gerado. No terminal do servidor, cole esse código quando ele pedir o "Password".

Passo 3: Recriando o arquivo de Senhas (O Mais Importante!)

Se você seguiu as boas práticas e utilizou o .gitignore para esconder as senhas do banco de dados (arquivos como config.php ou .env), você vai notar que o sistema dará erro ao tentar acessar o banco de dados. Isso é excelente! Significa que suas senhas estão seguras e não vieram do GitHub. Porém, para o sistema funcionar no servidor, você precisará recriar esse arquivo manualmente: No terminal do servidor, crie o arquivo que foi ignorado:

nano config.php

(Substitua config.php pelo nome do seu arquivo de configuração). Escreva ou cole o código com os dados de conexão do banco de dados do seu servidor (Usuário, Senha, Nome do Banco, etc). Salve e feche o arquivo. Pronto! Agora o seu servidor tem o código atualizado do GitHub e o arquivo de configuração seguro que só existe localmente.

Passo 4: Atualizações Futuras

A partir de agora, o repositório já existe no servidor. Sempre que você trabalhar no seu computador pelo VSCode e enviar alterações para o GitHub (usando git push), basta acessar o servidor novamente, ir até a pasta do projeto e digitar:

git pull origin main

O servidor vai baixar apenas os arquivos novos do GitHub sem tocar no seu arquivo config.php protegido. </pre>