Este guia ajuda você a configurar o Git com HTTPS e SSH e a vincular seu repositório local ao GitHub.
Configuração
Autenticação
Repositório remoto
Branch master
Subir o código para o GitHub
Alterações no código
Commits
Commits Semânticos
Resumo
Se ainda não tem o Git, faça o download pelo site oficial do Git e siga as instruções de instalação.
Verifique a instalação com:
git --versionUse --global para que o nome e e-mail sejam aplicados a todos os repositórios da sua máquina:
git config --global user.name "Seu Nome"
git config --global user.email "seu-email@example.com"Para definir nome e e-mail apenas para um repositório, navegue até o diretório desse repositório e use os mesmos comandos sem o --global:
cd caminho/do/seu/repositorio
git config user.name "Nome Específico"
git config user.email "email-especifico@exemplo.com"🤓 Dica: Isso é útil para projetos que exigem configurações diferentes (como um e-mail de trabalho e outro pessoal).
Para verificar as configurações e suas origens, use:
git config --list --show-originVocê pode autenticar no GitHub de duas maneiras: com HTTPS (token de acesso) ou com SSH (chave SSH).
-
Crie um Token de Acesso no GitHub:
- Vá para Configurações do GitHub > Developer settings > Personal access tokens > Tokens classic > Generate new token.
- Escolha as permissões necessárias e clique em Generate token. Guarde o token em local seguro, pois ele será exibido apenas uma vez.
-
Clonar o Repositório com HTTPS: Use o URL no formato HTTPS ao clonar um repositório do GitHub:
git clone https://github.com/username/repo-name.git
-
Autenticar com o Token:
-
Quando solicitado por nome de usuário e senha, insira seu nome de usuário do GitHub e o token de acesso como senha.
-
Para evitar digitar o token sempre, configure o gerenciador de credenciais do Git:
git config --global credential.helper cache
-
-
Gerar uma Chave SSH: No terminal, execute o seguinte comando (substitua o e-mail pelo seu):
ssh-keygen -t ed25519 -C "seu-email@example.com"- Pressione Enter para aceitar o local padrão para salvar a chave.
- Opcionalmente, adicione uma senha para segurança adicional.
-
Adicionar a Chave SSH ao
ssh-agent: No terminal, execute:eval "$(ssh-agent -s)" ssh-add ~/.ssh/id_ed25519
-
Adicionar a Chave SSH ao GitHub:
-
Copie a chave pública (parte
.pub) com:cat ~/.ssh/id_ed25519.pub -
No GitHub, vá até Configurações de Chaves SSH > SSH and GPG keys > New SSH key e cole a chave pública.
-
-
Clonar o Repositório com SSH: Após configurar a chave SSH, clone o repositório usando o link SSH:
git clone git@github.com:username/repo-name.git
-
Testar a Conexão SSH: Verifique se o GitHub reconhece sua chave SSH:
ssh -T git@github.com
Caso tenha um repositório local que deseja vincular ao GitHub, siga estes passos:
-
Adicione o Repositório Remoto:
-
Com HTTPS:
git remote add origin https://github.com/username/repo-name.git
-
Com SSH:
git remote add origin git@github.com:username/repo-name.git
-
-
Enviar o Código para o GitHub:
Depois de adicionar o repositório remoto, você pode enviar seus commits para o GitHub:
git push -u origin main
📝 Nota: Substitua
mainpelo nome da sua branch principal, caso seja diferente.
A branch master foi historicamente o nome padrão para a branch principal de repositórios Git, mas nos últimos anos, devido a preocupações com a terminologia, muitas plataformas e projetos decidiram descontinuar o uso da branch master em favor de nomes mais neutros, como main, primary ou outros termos. A mudança está sendo promovida para refletir uma linguagem mais inclusiva e respeitosa em relação a questões sociais.
O uso do termo master foi associado a conotações históricas que não são mais vistas como apropriadas em um contexto moderno e inclusivo. Para promover um ambiente mais acolhedor e livre de termos potencialmente problemáticos, a indústria de software começou a substituir a branch master por uma alternativa mais neutra.
-
GitHub e outras plataformas: O GitHub, GitLab e outras plataformas populares começaram a adotar
maincomo o nome padrão para a branch principal em novos repositórios. Isso significa que quando você cria um novo repositório, a branch principal automaticamente será nomeada comomain, em vez demaster. Para saber mais, acesse o site oficial ou leia esse arquivo. -
Migração: Para repositórios já existentes, a mudança não é obrigatória. Contudo, é altamente recomendada para que os projetos sigam as melhores práticas inclusivas e estejam alinhados com as diretrizes mais recentes. O GitHub, por exemplo, oferece uma maneira simples de renomear a branch
masterparamainsem afetar o histórico do projeto.
Se você está mantendo um repositório que usa master e deseja mudar para main, pode fazer isso facilmente com os seguintes comandos Git:
-
Renomeie a branch local:
git branch -m master main
-
Atualize o repositório remoto: Após renomear a branch local, você precisará fazer a atualização no repositório remoto (GitHub, GitLab, etc.):
git push -u origin main
-
Altere a branch padrão no GitHub:
- Vá para seu repositório no GitHub.
- Clique em Settings > Branches.
- Em "Default branch", altere de
masterparamain.
-
Excluir a antiga branch
masterno repositório remoto (se desejado): Após garantir que tudo está funcionando com a nova branch, você pode excluir amasterremota para evitar confusão:git push origin --delete master
Embora o GitHub tenha iniciado a mudança em 2020, o processo de substituição do uso de master como padrão ainda está em andamento. Muitos projetos ainda estão em transição, mas a tendência é que o uso de master diminua ao longo do tempo, com a maioria dos novos repositórios já adotando main ou outro nome neutro como padrão.
Embora a mudança não seja obrigatória para repositórios antigos, é importante adotar uma terminologia mais inclusiva, alinhada com as melhores práticas da comunidade. Se você ainda usa master, considere renomeá-la para main para garantir que seu projeto esteja alinhado com a evolução da linguagem e as práticas modernas de desenvolvimento.
- Acesse o site: https://github.com.
- Clique em "Sign up" no canto superior direito.
- Preencha o formulário com seu nome, e-mail, senha e clique em "Create account".
- Siga as instruções para concluir o processo de configuração da sua conta (verificação de e-mail, escolha do plano, etc.).
Vamos simular a estrutura de um projeto simples com uma pasta source e um arquivo index.html.
meu-projeto/
│
├── source/
│ └── style.css
│__ index.html
└── README.md
<!DOCTYPE html>
<html lang="pt-br">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Meu Projeto</title>
</head>
<body>
<h1>Bem-vindo ao Meu Projeto!</h1>
<p>Este é um projeto simples que estou subindo para o GitHub.</p>
</body>
</html>-
Abra o terminal:
- Git Bash: Clique com o botão direito na pasta do seu projeto e selecione Git Bash Here.
- Terminal (macOS/Linux) ou PowerShell (Windows): Abra a janela do terminal na pasta onde está o projeto.
-
Inicialize o repositório Git: No terminal, navegue até a pasta do seu projeto e execute o comando para inicializar o repositório:
git init
-
Adicione os arquivos ao Git: Adicione todos os arquivos do projeto ao Git:
git add . -
Crie o primeiro commit: Execute o commit inicial com uma mensagem explicativa:
git commit -m "Primeiro commit - subindo o projeto para o GitHub" -
Adicione o repositório remoto: Crie um repositório no GitHub e copie a URL do repositório (por exemplo,
https://github.com/username/nome-do-repositorio.git).Adicione o repositório remoto:
git remote add origin https://github.com/username/nome-do-repositorio.git
-
** Enviar o Código para o GitHub**:
- Acesse seu GitHub e crie um novo repositório clicando no botão "New repository".
- Dica: O GitHub agora usa a branch
mainpor padrão para novos repositórios, então o nome da branch principal será automaticamentemain.
-
Adicionar o repositório remoto: No seu terminal, depois de criar o repositório no GitHub, adicione o repositório remoto:
git remote add origin https://github.com/username/nome-do-repositorio.git
-
Envie os arquivos para o GitHub: Agora, envie seu código para o repositório remoto. Se você estiver usando a branch
main, execute o comando:git push -u origin main
Caso esteja usando
master, o comando será:git push -u origin master
⚠️ Atenção: Se o repositório já tiver sido criado com a branchmaster, você precisa renomear essa branch paramain, como discutido anteriormente, para seguir as melhores práticas. O GitHub e outras plataformas estão movendo-se em direção a uma terminologia mais inclusiva, substituindomasterpormain.
Se você preferir uma interface gráfica, pode fazer isso sem usar o terminal. Embora a maneira mais comum de interagir com Git seja por meio da linha de comando, o GitHub permite carregar arquivos diretamente pela interface web.
-
Crie o repositório no GitHub:
- Vá para GitHub e faça login.
- Clique em + no canto superior direito e selecione New repository.
- Dê um nome ao seu repositório e clique em Create repository.
-
Faça o upload dos arquivos:
- No seu repositório no GitHub, clique em Upload files.
- Arraste e solte os arquivos do seu projeto ou use o botão choose your files para selecionar os arquivos.
- Clique em Commit changes para enviar os arquivos.
💡 Dica: Embora essa opção seja fácil, ela não é ideal para grandes projetos ou quando você precisar gerenciar várias versões de arquivos. O uso do Git Bash ou GitHub Desktop é recomendado para projetos mais avançados.
Após subir o projeto para o GitHub, você pode começar a gerenciar o código de várias maneiras:
-
Faça alterações no código (por exemplo, edite
index.html). -
No terminal, adicione as alterações:
git add . -
Comite as mudanças:
git commit -m "Alterações no index.html" -
Envie para o GitHub:
git push origin main
Agora, o GitHub estará atualizado com as últimas alterações feitas no código.
- Criar conta no GitHub: Crie um perfil no GitHub para hospedar seus repositórios.
- Estruturar o projeto: Crie a estrutura de pastas e arquivos.
- Subir para o GitHub:
- Usando Git Bash/Terminal/PowerShell ou o Gerenciador de Arquivos no GitHub.
- Gerenciar alterações: Use o Git para adicionar, commitar e enviar novas versões para o GitHub.
Agora você está pronto para usar o Git e o GitHub de forma eficiente para gerenciar seus projetos! 🚀
Para garantir que suas alterações no código sejam bem organizadas e compreensíveis, é importante seguir boas práticas de commit. Isso inclui fazer commits de forma frequente e usando commits semânticos.
Sempre que você realizar alguma alteração no código, como adicionar uma nova funcionalidade, corrigir um bug ou refatorar uma parte do código, faça isso de forma incremental. Isso significa que você não deve esperar até que o código esteja completamente finalizado para fazer um commit.
É recomendado realizar commits pequenos e frequentes. Isso permite que o histórico do seu projeto seja claro, e facilita a identificação de problemas, caso algum erro aconteça após a alteração.
Por exemplo, se você está trabalhando em uma página de login, você pode:
- Fazer um commit para adicionar o formulário de login.
- Fazer outro commit para validar os campos do formulário.
- Fazer um terceiro commit para conectar o formulário com a API de login.
Isso torna o histórico de commits mais legível e facilita o processo de revisão de código.
Evite fazer commits grandes que englobam múltiplas alterações. Em vez disso, faça commits de forma regular, de preferência sempre que terminar uma tarefa ou uma unidade de trabalho específica.
Aqui estão algumas situações em que é adequado fazer um commit:
- Após adicionar uma nova funcionalidade (ex.: "Adicionar formulário de login").
- Após corrigir um bug (ex.: "Corrigir erro na validação do e-mail").
- Após refatorar ou melhorar o código (ex.: "Refatorar função de validação do formulário").
- Após testes ou ajustes (ex.: "Ajustar layout da página de login para mobile").
Isso ajuda a manter o histórico do projeto claro e organizado, além de permitir reverter facilmente a qualquer ponto anterior, caso necessário.
Os commits semânticos seguem uma convenção específica para que o significado de cada commit seja claro. Em vez de apenas escrever algo como "Alterações no código", você deve usar mensagens de commit mais descritivas e estruturadas, com base no tipo de alteração que está sendo feita.
Aqui estão os principais tipos de commits semânticos:
- feat: Adição de nova funcionalidade ao código (ex.: "feat: adicionar formulário de login").
- fix: Correção de um bug no código (ex.: "fix: corrigir erro de validação do e-mail").
- docs: Modificações na documentação do projeto (ex.: "docs: atualizar README com instruções de instalação").
- style: Alterações que não afetam a lógica do código, como mudanças de estilo (ex.: "style: ajustar indentação e espaçamento").
- refactor: Alterações no código que não adicionam funcionalidades nem corrigem bugs, mas melhoram a estrutura (ex.: "refactor: melhorar a legibilidade da função de validação").
- test: Alterações relacionadas a testes (ex.: "test: adicionar testes para a função de login").
- chore: Alterações que não se encaixam em outras categorias (ex.: "chore: atualizar dependências do projeto").
git commit -m "feat: adicionar página de login"
git commit -m "fix: corrigir erro no envio de dados do formulário"
git commit -m "docs: atualizar o README com informações de configuração"
git commit -m "style: corrigir indentação na função de validação"Você pode ler mais sobre commits semânticos e sua importância neste repositório:
Após fazer as alterações no seu código, você precisa adicionar os arquivos modificados ao Git e fazer o commit.
-
Adicionar os arquivos alterados:
git add . -
Fazer o commit com uma mensagem semântica:
git commit -m "feat: adicionar a página de login" -
Enviar as alterações para o repositório remoto no GitHub:
git push origin main
- Histórico de código mais claro: Facilita o entendimento das mudanças feitas no projeto, especialmente em equipes.
- Facilidade de reversão: Com commits pequenos e claros, é mais fácil reverter alterações específicas.
- Melhoria na colaboração: Equipes podem trabalhar de forma mais eficiente com um histórico de commits bem estruturado.
- Automação e integrações: Algumas ferramentas, como CI/CD (Integração Contínua/Entrega Contínua), podem se beneficiar de mensagens de commit claras e bem estruturadas para automatizar o fluxo de trabalho.
| Passo | Descrição | Comando/Link |
|---|---|---|
| 1 | Instalar o Git | Site oficial do Git |
| 2 | Configurar Usuário e E-mail no Git (Global) | git config --global user.name "Seu Nome"git config --global user.email "seu-email@example.com" |
| 3 | Configurar Usuário e E-mail no Git (Local) | cd caminho/do/seu/repositoriogit config user.name "Nome Específico"git config user.email "email-especifico@exemplo.com" |
| 4 | Verificar Configurações do Git | git config --list --show-origin |
| 5 | Autenticação no GitHub via HTTPS (Token de Acesso) | Criar Token no GitHubgit clone https://github.com/username/repo-name.gitgit config --global credential.helper cache |
| 6 | Autenticação no GitHub via SSH (Chave SSH) | ssh-keygen -t ed25519 -C "seu-email@example.com"eval "$(ssh-agent -s)"ssh-add ~/.ssh/id_ed25519Adicionar chave SSH ao GitHub |
| 7 | Clonar Repositório com HTTPS | git clone https://github.com/username/repo-name.git |
| 8 | Clonar Repositório com SSH | git clone git@github.com:username/repo-name.git |
| 9 | Vincular Repositório Local ao GitHub (HTTPS) | git remote add origin https://github.com/username/repo-name.git |
| 10 | Vincular Repositório Local ao GitHub (SSH) | git remote add origin git@github.com:username/repo-name.git |
| 11 | Enviar Código para o GitHub | git push -u origin main |
| 12 | Renomear Branch master para main (opcional) |
git branch -m master maingit push -u origin maingit push origin --delete master |
| 13 | Testar Conexão SSH | ssh -T git@github.com |
| 14 | Criar Conta no GitHub | Criar conta no GitHub |
| 15 | Estrutura de Projeto Simulada | Ver estrutura: meu-projeto/source/index.html |
| 16 | Inicializar Repositório Git | git init |
| 17 | Adicionar Arquivos ao Git | git add . |
| 18 | Fazer o Primeiro Commit | git commit -m "Primeiro commit - subindo o projeto para o GitHub" |
| 19 | Adicionar Repositório Remoto | git remote add origin https://github.com/username/nome-do-repositorio.git |