Como usar o GitHub no Ubuntu: Guia completo do iniciante ao avançado com Git, SSH e VS Code

.

1. Introdução

Por que conectar o Ubuntu ao GitHub?

Nos últimos anos, o uso de Git e GitHub tornou‑se prática padrão no desenvolvimento de software e nas operações de sistemas. Para engenheiros e programadores que trabalham em ambientes Linux como o Ubuntu, integrar‑se ao GitHub faz parte do fluxo de trabalho diário.

Git é uma ferramenta para gerenciar o histórico de versões do código‑fonte e é essencial para a colaboração eficiente entre vários desenvolvedores. GitHub, por sua vez, é um serviço de hospedagem que permite que repositórios gerenciados por Git sejam compartilhados e publicados online, servindo como um hub global para desenvolvedores trocarem código.

Por que usar o GitHub no Ubuntu?

Ubuntu é uma distribuição Linux muito popular entre desenvolvedores e é conhecida por sua excelente compatibilidade com desenvolvimento de código aberto. Ela fornece um ambiente onde Git e outras ferramentas de desenvolvimento podem ser instaladas facilmente, tornando a integração com o GitHub fluida e eficiente.

Casos de uso típicos para combinar Ubuntu e GitHub incluem:

• Gerenciar e compartilhar Python, C++ e outros códigos‑fonte no GitHub
• Contribuir para projetos de código aberto
• Publicar seu trabalho como portfólio

O que você aprenderá neste artigo

Este guia explica tudo, do básico ao avançado, sobre o uso do GitHub no Ubuntu através dos passos a seguir:

• Como instalar o Git no Ubuntu
• Configuração inicial do Git e setup de SSH
• Criação e gerenciamento de repositórios no GitHub
• Desenvolvimento eficiente usando o Visual Studio Code
• Dicas comuns de solução de problemas e FAQs

Mesmo usuários iniciantes no GitHub podem seguir com segurança, com exemplos reais de comandos e notas importantes incluídas. Se você quer aproveitar ao máximo o GitHub no Ubuntu, continue lendo até o final.

2. Instalando o Git no Ubuntu

O que é Git? Um rápido repasso

Git é um Sistema de Controle de Versão (VCS) usado no desenvolvimento de software para gerenciar o histórico de alterações do código‑fonte. Ele permite que desenvolvedores restaurem estados anteriores e colaborem simultaneamente.

Uma grande vantagem dos ambientes Linux como o Ubuntu é a facilidade de instalar o Git. Usando o método abaixo, a instalação pode ser concluída em minutos via terminal.

Instalando o Git via APT

A forma mais comum de instalar o Git no Ubuntu é usando APT (Advanced Package Tool). Siga estes passos:

1. Atualizar a lista de pacotes

sudo apt update

Este comando obtém as informações mais recentes dos pacotes. Sempre execute‑o antes de instalar um novo software.

2. Instalar o Git

sudo apt install git

Quando for solicitado “Y/n”, digite y e pressione Enter para iniciar a instalação.

Verificar a instalação do Git

Após a instalação, confirme se o Git foi instalado corretamente:

git --version

Se você vir uma saída semelhante à seguinte, o Git foi instalado com sucesso:

git version 2.34.1

O número da versão pode variar conforme a sua versão do Ubuntu, mas qualquer número de versão exibido confirma o sucesso.

Instalando via Snap (Opcional)

Embora o Git também possa ser instalado usando o comando snap, APT é geralmente mais estável e amplamente usado. A menos que você tenha um motivo específico, recomenda‑se usar o APT.

3. Configuração inicial do Git

Configurações essenciais antes de usar o Git

Depois que o Git estiver instalado, o próximo passo é configurar informações do usuário e autenticação. Uma configuração correta garante interação fluida com repositórios remotos e fluxos de trabalho em equipe.

Definindo nome de usuário e e‑mail no Git

O Git registra quem fez cada commit. Portanto, você deve configurar um nome de usuário e um endereço de e‑mail.

Comandos de configuração

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Esses valores não precisam coincidir exatamente com a sua conta do GitHub, mas usar o mesmo e‑mail do GitHub ajuda a associar os commits corretamente.

Verificar a configuração

git config --list

Este comando exibe a configuração atual do seu Git.

Gerando e registrando chaves SSH

Embora o HTTPS seja suportado, a autenticação SSH elimina solicitações repetidas de senha e oferece um fluxo de trabalho mais seguro e eficiente.

1. Gere uma Chave SSH

ssh-keygen -t ed25519 -C "you@example.com"

Pressione Enter várias vezes para gerar uma chave privada (~/.ssh/id_ed25519) e uma chave pública (~/.ssh/id_ed25519.pub).

2. Inicie o Agente SSH e Adicione a Chave

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

A chave SSH está pronta para uso.

3. Adicione a Chave Pública ao GitHub

Copie a chave pública:

cat ~/.ssh/id_ed25519.pub

Em seguida, registre-a no GitHub:

1. Faça login no GitHub
2. Clique na sua imagem de perfil → Configurações
3. Selecione “SSH e chaves GPG”
4. Clique em “New SSH key”, cole a chave e salve

4. Teste a Conexão SSH

ssh -T git@github.com

Digite yes quando solicitado a confiar no host.

Se for bem-sucedido, você verá:

Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

Próximos Passos Recomendados

Com esta configuração concluída, você agora pode clonar, enviar (push) e puxar (pull) repositórios do GitHub. A próxima seção explica como criar e operar repositórios do GitHub na prática.

4. Trabalhando com Repositórios do GitHub

Criando um Novo Repositório no GitHub

Depois de fazer login no GitHub, comece criando um novo repositório.

Etapas (via Navegador Web)

1. Clique no botão “+” no canto superior direito da página inicial do GitHub e selecione “New repository”.
2. Insira as seguintes informações:

• Nome do repositório : Exemplo: my-first-repo
• Descrição (opcional) : Uma breve explicação
• Público / Privado : Escolha a visibilidade do repositório

1. Clique em “Create repository”.

Após a criação, a URL do repositório será exibida. Você usará essa URL para clonar e gerenciar o repositório.

Clonando um Repositório Existente do GitHub

Para copiar um repositório para seu ambiente local Ubuntu, use o comando git clone.

git clone git@github.com:your-username/my-first-repo.git

Este exemplo usa SSH. Se você usar HTTPS, a URL será diferente.

Após a execução, um diretório chamado my-first-repo será criado contendo os arquivos do repositório.

Alterações de Arquivo, Staging e Fluxo de Trabalho de Commit

1. Adicionar ou Editar Arquivos

Por exemplo, crie um novo arquivo:

echo "# My First GitHub Project" > README.md

2. Stage (Preparar) as Alterações

git add README.md

O staging seleciona quais alterações serão incluídas no próximo commit.

3. Commitar as Alterações

git commit -m "Initial commit: add README.md"

Suas alterações agora estão salvas no histórico do repositório local.

Enviando Alterações para o GitHub

Para refletir as alterações locais no repositório remoto do GitHub, use git push.

git push origin main

Se seu branch padrão não for main (por exemplo, master), ajuste o nome do branch de acordo.

Puxando Alterações Remotas para o Local

Se outro desenvolvedor fez alterações, use o comando a seguir para atualizar seu repositório local:

git pull origin main

Isso mescla as alterações remotas ao seu branch local.

Operações Adicionais Comuns

• Verificar repositórios remotos:

  git remote -v
  

• Adicionar outro repositório GitHub mais tarde:

  git remote add origin git@github.com:your-username/another-repo.git
  

• Editar README.md ou .gitignore segue o mesmo fluxo de trabalho.

5. Integração com o Visual Studio Code

Por que o VS Code é Ideal para Operações Git

Ao usar o GitHub no Ubuntu, combiná-lo com Visual Studio Code (VS Code) melhora significativamente a produtividade. O VS Code é um editor de código aberto desenvolvido pela Microsoft e é conhecido por sua excelente integração com Git. Ele permite commits, pushes e revisões de diff via interface gráfica, tornando‑o amigável para iniciantes.

Instalando o VS Code no Ubuntu

Você pode instalar o VS Code no Ubuntu facilmente usando os passos a seguir.

1. Adicione o Repositório da Microsoft

.

sudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/

2. Registrar o Repositório

sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

3. Instalar o VS Code

sudo apt update
sudo apt install code

Após a instalação, você pode iniciar o VS Code digitando code no terminal.

Suporte Git Integrado

O VS Code inclui integração com Git por padrão, portanto nenhum plugin adicional é necessário para operações Git básicas. Para usos avançados, as seguintes extensões são recomendadas:

• GitHub Pull Requests and Issues Permite o gerenciamento de Pull Requests e Issues por interface gráfica.
• GitLens Visualiza o histórico linha a linha, mostrando quem alterou o quê e quando.

Operações Git Básicas no VS Code

Abrindo um Repositório

Navegue até o seu repositório clonado e execute:

code .

Revisando Alterações e Commitando

• Clique no ícone de Controle de Código‑Fonte na barra lateral esquerda
• Visualize a lista de arquivos modificados
• Selecione um arquivo para ver as diferenças
• Insira uma mensagem de commit e clique no ícone ✓

Operações de Push e Pull

• Selecione “Push” ou “Pull” no menu “…”
• Ou use a barra de status no canto inferior direito

Usando o Terminal Integrado

O terminal integrado (Ctrl + `) permite alternar perfeitamente entre fluxos de trabalho GUI e CLI. Por exemplo, você pode fazer commit via interface gráfica e gerenciar branches via terminal.

Dicas de Solução de Problemas

• Se ocorrerem erros de SSH, verifique se o VS Code está referenciando a chave SSH correta
• Pode ser necessário reconfigurar a autenticação ou usar um Token de Acesso Pessoal do GitHub (PAT)

6. Solução de Problemas Comuns

Erro SSH: “Permission denied (publickey).”

Causas Possíveis

• As chaves SSH não foram geradas corretamente
• A chave pública não está registrada no GitHub
• O agente SSH não está carregando a chave

Soluções

1. Verifique se já existe uma chave SSH:

   ls ~/.ssh/id_ed25519.pub
   

Se não existir, gere uma nova:

ssh-keygen -t ed25519 -C "your_email@example.com"

2. Inicie o agente SSH e adicione a chave:

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_ed25519
   

3. Adicione a chave pública ao GitHub:

   cat ~/.ssh/id_ed25519.pub
   

Adicione-a em “SSH and GPG keys” no GitHub.

4. Teste a conexão:

   ssh -T git@github.com
   

Erro de Autenticação com HTTPS

Causa

• A autenticação por senha foi descontinuada; é necessária autenticação baseada em token

Solução

1. Crie um Token de Acesso Pessoal no GitHub https://github.com/settings/tokens Marque o escopo repo ao criar o token
2. Use seu nome de usuário do GitHub e a string do token como senha
3. Habilite o cache de credenciais, se desejar:

   git config --global credential.helper cache
   

Erro: “fatal: not a git repository”

Causa

• O diretório atual não é um repositório Git

Solução

• Entre em um diretório de repositório existente:

  cd ~/your-project-directory
  

• Ou inicialize um novo repositório:

  git init
  

Lidando com Conflitos de Merge

Causa

• Conflitos ocorrem quando vários usuários editam a mesma seção de um arquivo simultaneamente

Solução

1. Abra o arquivo em conflito após um erro de git pull
2. Procure pelos marcadores de conflito:

   <<<<<<< HEAD
   Your changes
   =======
   Other changes
   >>>>>>> origin/main
   

3. Edite o conteúdo, remova os marcadores e salve
4. Em seguida, execute:

   git add .
   git commit
   

Erro: “remote: Repository not found.”

Causa

• URL do repositório incorreta
• Falta de permissão de acesso ao repositório

Solução

• Verifique a URL remota:

  git remote -v
  

• Redefina a URL, se necessário:

  git remote set-url origin git@github.com:your-username/your-repo.git
  

Esses problemas ocorrem comumente para iniciantes. No entanto, com causas claras e soluções, eles podem ser resolvidos calmamente. Trate os erros como oportunidades de aprendizado e construa confiança gradualmente.

7. FAQ

Q1. Qual é a Diferença Entre Git e GitHub?

A:
Git é uma ferramenta de controle de versão que gerencia o histórico de mudanças localmente. GitHub é um serviço em nuvem que hospeda repositórios Git e permite compartilhamento e colaboração.

• Git: Gerenciamento local e offline de histórico
• GitHub: Hospedagem de repositório online e colaboração

Q2. Devo Usar SSH ou HTTPS?

A:
O SSH é recomendado porque:

• Sem digitação repetida de senha
• Mais seguro e conveniente a longo prazo

No entanto, o HTTPS pode ser necessário em certos ambientes corporativos ou de rede.

Q3. Como Posso Usar Múltiplas Contas do GitHub no Ubuntu?

A:
Gere chaves SSH separadas para cada conta e configure-as explicitamente.

1. Crie chaves SSH separadas Exemplos: ~/.ssh/id_ed25519_work , ~/.ssh/id_ed25519_personal
2. Edite ~/.ssh/config :

   Host github.com-work
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_work
   
   Host github.com-personal
       HostName github.com
       User git
       IdentityFile ~/.ssh/id_ed25519_personal
   

3. Atualize a URL remota:

   git remote set-url origin git@github.com-work:your-work-user/your-repo.git
   

Q4. Posso Usar o Git com uma Interface Gráfica (GUI)?

A:
Sim. O Visual Studio Code fornece operações Git baseadas em GUI, incluindo commits, pushes, diffs e gerenciamento de branches. É altamente recomendado para iniciantes.

Q5. O Que Acontece Se Eu Deletar o Repositório Remoto?

A:
Deletar um repositório remoto não afeta o repositório local. No entanto, git push falhará.

Você pode reconectar a um novo remoto da seguinte forma:

git remote set-url origin git@github.com:new-user/new-repo.git

Q6. É Possível Evitar o Terminal Completamente?

A:
Sim. Clientes Git com GUI permitem fluxos de trabalho sem terminal:

• GitKraken
• Sourcetree (não suportado oficialmente no Linux)
• Visual Studio Code (suporte integrado ao Git)

Para usuários do Ubuntu, a combinação VS Code + GitLens é a mais prática e amigável ao usuário.

Q7. Até Onde o Histórico do Git Pode Retroceder?

A:
O Git preserva todo o histórico desde o primeiro commit. Você pode visualizá-lo usando:

git log

Para visualizar o histórico de um arquivo específico:

git log path/to/file