<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Como subir um projeto no GitHub em 6 passos: comandos do init ao push

DA

7 min

Como subir um projeto no GitHub em 6 passos: comandos do init ao push

Aprenda a subir um projeto no GitHub pelo terminal em 6 passos: criar o repositório, init, commit, push e como mandar atualizações sem repetir nada.

Neste artigo

Subir um projeto no GitHub pelo terminal depende de quatro comandos: git init, git add, git commit e git push. O caminho completo tem seis passos, do momento em que você cria o repositório no site até o primeiro envio dos arquivos. Se a sua base de versionamento ainda está fraca, comece medindo o terreno neste quiz de Git e GitHub para iniciantes.

O processo funciona igual para qualquer linguagem: um site em HTML, uma API em Python ou o trabalho da faculdade. O que muda é o conteúdo da pasta, nunca a sequência. O fluxo abaixo segue a orientação da documentação oficial do GitHub para código que está na sua máquina e ainda não tem versionamento.

O que você precisa antes de subir um projeto no GitHub?

Três coisas: conta no GitHub, Git instalado na máquina e seus dados de autoria configurados. A instalação do Git varia por sistema operacional e está coberta no site oficial do Git. Depois de instalar, registre o nome e o e-mail que vão aparecer em cada commit:

git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"

Passo 1: crie o repositório no GitHub

Com login feito em github.com, clique no sinal de mais no canto superior direito e escolha "New repository". Dê um nome descritivo ao projeto, defina se ele será público ou privado e não marque as opções de README, licença ou .gitignore. A documentação do GitHub orienta criar o repositório vazio justamente para evitar conflito entre o que existe no site e o que existe na sua pasta local. Esses arquivos podem ser adicionados depois do push.

Passo 2: inicialize o Git na pasta do projeto

No terminal, entre na pasta do projeto e transforme ela em um repositório:

cd /caminho/do/seu/projeto
git init -b main

A flag -b main define o nome da branch inicial no mesmo comando. A documentação do GitHub usa main como padrão e avisa que essa sintaxe exige Git 2.28.0 ou mais recente. Se a sua versão for anterior, rode git init simples e ajuste o nome da branch antes do push, como os próprios docs indicam para versões antigas.

Passo 3: prepare os arquivos e faça o primeiro commit

Antes de mandar tudo, separe o que não deve ir para o GitHub: senhas, chaves de API e arquivos gerados automaticamente ficam no .gitignore. O aviso da documentação é direto: nunca adicione, commite ou envie informações sensíveis para um repositório remoto. Com a lista pronta, prepare e grave a primeira versão:

git status
git add .
git commit -m "primeiro commit"

O git status mostra o que mudou na pasta. O git add . prepara todos os arquivos de uma vez, e o commit grava essa versão no histórico local. Se preferir ir com calma, adicione arquivo por arquivo com git add nome-do-arquivo e revise o status entre cada etapa.

Passo 4: conecte o repositório local ao remoto

Volte à página do repositório no GitHub, clique em "Code" e copie a URL. Registre ela como destino do seu projeto:

git remote add origin https://github.com/seu-usuario/seu-repositorio.git
git remote -v

O origin é apenas o apelido do endereço remoto, um nome que o Git adotou por convenção. O git remote -v confirma se a URL foi registrada direitinho, o que evita a clássica surpresa do push indo para o lugar errado.

Passo 5: envie o projeto com git push

git push -u origin main

O push transfere seus commits para o GitHub. A flag -u grava a relação entre a branch local e a remota, então nos próximos envios um git push simples resolve. Se a sua branch se chamar de outra forma, substitua main pelo nome real no comando, recomendação que a própria documentação repete.

Passo 6: suba atualizações sem repetir a configuração

Depois do primeiro envio, atualizar o projeto vira um ciclo curto de três comandos:

git add .
git commit -m "ajusta validação do formulário"
git push

Cada alteração segue esse caminho, sempre com uma mensagem que descreva o que mudou. Commits frequentes e mensagens claras contam a história do projeto e ajudam quem for ler o repositório depois, inclusive você daqui a seis meses.

Quais comandos resumem como subir um projeto no GitHub?

Para consulta rápida, esta é a sequência completa de um projeto que sai da sua pasta para o GitHub pela primeira vez:

EtapaComando
Iniciar o repositóriogit init -b main
Ver o que mudougit status
Preparar arquivosgit add .
Gravar versãogit commit -m "mensagem"
Conectar ao remotogit remote add origin URL
Enviar pela primeira vezgit push -u origin main
Atualizar depoisgit add ., git commit, git push

Dá para subir projeto no GitHub sem usar o terminal?

Dá. A documentação oficial lista duas alternativas. A primeira é o GitHub CLI: com a ferramenta instalada, um comando cria o repositório remoto, conecta o local e envia os arquivos:

gh repo create --source=. --public

A segunda é o GitHub Desktop, recomendado para quem prefere interface gráfica de apontar e clicar. Nos dois casos, a lógica é a mesma do terminal: iniciar, commitar e publicar. O que muda é quem digita os comandos.

💡 Dica: se o push pedir credenciais, o GitHub não aceita mais a senha da conta em operações Git. A documentação orienta usar um token de acesso pessoal ou o gerenciador de credenciais do próprio Git.

A referência completa deste fluxo, com as variações para quem usa GitHub CLI ou GitHub Desktop, está na página oficial Adding locally hosted code to GitHub dos GitHub Docs. Guardar o endereço salva tempo quando um passo sair do esperado.

Por que publicar seus projetos no GitHub?

Porque repositório é vitrine. Quem contrata dev iniciante olha código publicado antes de olhar certificado, e um perfil com projetos organizados sustenta tanto o currículo quanto a entrevista. Um portfólio dev que impressiona quase sempre nasce de uma conta do GitHub bem cuidada, e saber destacar um projeto no portfólio vale tanto quanto saber commitar.

Se faltam projetos para publicar, há uma lista de 10 projetos simples para treinar programação por onde começar. E se você programa no Visual Studio Code, o painel Source Control executa esse mesmo ciclo de add, commit e push pela interface, sem tocar no terminal. O tutorial de como usar o Visual Studio Code para começar a programar mostra o caminho.

Perguntas frequentes

Posso subir um projeto no GitHub sem instalar o Git?

Para testar, sim: em um repositório já criado, o próprio site permite criar arquivos e enviar arquivos pelo navegador. Para um projeto real, o terminal, o GitHub CLI ou o GitHub Desktop são bem mais práticos, porque o versionamento completo acontece na sua máquina.

O GitHub é gratuito?

A criação de conta e de repositórios públicos é gratuita. Recursos extras de times e empresas ficam em planos pagos, mas nada do fluxo deste tutorial depende de pagamento.

Por que o comando usa main e não master?

A documentação oficial do GitHub adota main como nome de branch inicial em todos os exemplos. Se o seu repositório local usa outro nome, a orientação é substituir main nos comandos de push pelo nome real da sua branch.

O que colocar no .gitignore?

Tudo que não precisa (ou não pode) ir para o repositório: senhas, chaves de API, arquivos de configuração pessoal, dependências baixadas e arquivos gerados pela execução do programa. O aviso da documentação do GitHub é inegociável: informação sensível nunca vai para um repositório remoto.

Como subir uma atualização no GitHub?

Repita o ciclo básico dentro da pasta do projeto: git add . para preparar as mudanças, git commit -m "mensagem" para gravar e git push para enviar. A configuração do remoto foi feita no primeiro envio, então ela não se repete.

Produtos relacionados

Este conteúdo tem links de afiliado: se você comprar por eles, podemos receber uma comissão sem custo extra para você. A escolha dos produtos segue critérios próprios e não é influenciada por comissão.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Atualizado em 01/11/2026 •

Ver perfil do autor

COMPARTILHAR