Configuração e Sincronização de Projetos no Git pelo Terminal

Este guia descreve como realizar o envio de arquivos locais para repositórios remotos no Git (como GitHub, Gitee ou GitLab) utilizando comandos de terminal. O processo inclui desde a preparação do ambiente até o push final das alterações.

Preparação do Ambiente

Antes de iniciar, verifique os seguintes pré-requisitos:

• Instalação do Git: Certifique-se de ter o Git instalado no sistema. Execute git --version no terminal para confirmar.
• Identificação do Usuário: Configure seu nome e email globalmente no Git usando: ``` git config --global user.seu_nome "João Silva" git config --global user.email "joao@exemplo.com"

• Repositório Remoto: Crie um repositório vazio na plataforma desejada (ex.: GitHub) e copie o endereço HTTPS ou SSH. Evite inicializar com arquivos como README.

Fluxo de Trabalho para Upload de Arquivos

Considere que seus arquivos estão no diretório /home/usuario/projetos/meu-app. Siga as etapas abaixo:

1. Acesse o Diretório do Projeto

cd /home/usuario/projetos/meu-app
ls -la  # Verifique os arquivos presentes

2. Inicialize o Repositório Git Local

git init --initial-branch=master

Cria uma pasta oculta .git no diretório atual.

3. Vincule o Repositório Remoto

Associe o endereço remoto ao repositório local usando um alias, como upstream:

git remote add upstream https://github.com/seu_usuario/meu-app.git
git remote -v  # Confira se a vinculação foi bem-sucedida

4. Prepare os Arquivos para Commit

Adicione os arquivos à área de staging. Para inccluir todos os arquivos, use:

git add --all

Para adicionar arquivos específicos, especifique-os:

git add README.md src/main.py

Para excluir arquivos sensíveis, crie um arquivo .gitignore com regras como *.log ou node_modules/.

5. Realize o Commit Local

Registre as alterações com uma mensagem descritiva:

git commit -m "Primeira versão do aplicativo: estrutura base implementada"

6. Envie as Alterações para o Repositório Remoto

No primeiro envio, associe a branch local à remota:

git push -u upstream master

Para envios subsequentes, utilize simplesmente:

git push

Se usar autenticação HTTPS, insira suas credenciais quando solicitado. Para SSH, configure chaves previamente.

Solução de Problemas Comuns

• Erro "rejected" ao fazer push: Geralmente ocorre quando o repositório remoto contém arquivos que o local não tem. Solucione com: ``` git pull upstream master --rebase git push -u upstream master

• Esqueceu de vincular o repositório remoto antes do commit: Execute git remote add upstream <url> e em seguida git push.
• Remover arquivos da staging area: Para desfazer a adição de todos os arquivos, use: ``` git reset HEAD

  
   Para um arquivo específico: ```
  git reset HEAD nome_arquivo.ext