> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usando o painel Git

> Aprenda a usar o painel Git para controle de versão, gerenciamento de branches e colaboração no Editor de Projetos.

O painel Git no Replit oferece uma interface visual para operações Git, eliminando a necessidade de usar comandos Git na linha de comando. Esse recurso torna o controle de versão acessível para iniciantes, mantendo sua potência para desenvolvedores experientes.

## Funcionalidades

O painel Git oferece recursos abrangentes de controle de versão diretamente no Editor de Projetos, com uma interface amigável que simplifica operações Git complexas.

* **Gerenciamento de repositório**: Inicialize, conecte e gerencie repositórios Git com integração ao GitHub
* **Rastreamento de commits**: Prepare, confirme e visualize alterações em todos os seus arquivos
* **Operações de branch**: Crie, alterne entre e mescle branches visualmente
* **Resolução de conflitos**: Identifique e resolva conflitos de mesclagem com auxílio visual
* **Integração com Shell**: Sincronização entre comandos Git executados no Shell e o painel Git

## Uso

### Configuração do repositório

<Accordion title="Como acessar o painel Git">
  1. Navegue até a seção de Ferramentas no seu App Replit
  2. Selecione o sinal **+** para adicionar novas ferramentas
  3. Selecione **Git** da lista de ferramentas disponíveis
</Accordion>

O painel Git ajuda você a configurar e conectar seu repositório:

* **Inicializar repositório**: Crie um novo repositório Git para o seu App Replit
* **Conectar ao GitHub**: Vincule seu repositório ao GitHub para backup e colaboração
* **Configurar remoto**: Configure e gerencie a conexão com seu repositório no GitHub

<Frame>
  <img src="https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/gh/pane/01-git-pane.png?fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=8173abb36daae9b8f60646cf259bf0dc" alt="Painel Git mostrando o botão de inicializar repositório" width="230" height="314" data-path="images/gh/pane/01-git-pane.png" />
</Frame>

### Gerenciamento de alterações

<Accordion title="Como visualizar alterações">
  1. Faça alterações em qualquer arquivo no seu App Replit
  2. Abra o painel Git na seção de Ferramentas
  3. Revise as alterações na seção **Review Changes**
</Accordion>

O painel Git fornece ferramentas para gerenciar as alterações do seu código:

* **Revisar alterações**: Veja arquivos modificados com adições e exclusões destacadas
* **Preparar arquivos**: Selecione arquivos específicos para incluir no próximo commit
* **Confirmar alterações**: Salve suas alterações com mensagens descritivas
* **Enviar atualizações**: Envie seus commits ao GitHub com um único clique

<Frame>
  <img src="https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/gh/pane/06-stage-commit-changes.png?fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=bf166d48de3a57be08343b79ea5ff900" alt="Painel Git mostrando o campo de mensagem de commit e opções de preparação" width="526" height="211" data-path="images/gh/pane/06-stage-commit-changes.png" />
</Frame>

<Note>
  Você pode usar o Replit AI para ajudar a gerar mensagens de commit que descrevam com precisão suas alterações.
</Note>

### Gerenciamento de branches

<Accordion title="Como gerenciar branches">
  1. Abra o painel Git na seção de Ferramentas
  2. Selecione o menu suspenso de branch ao lado do nome do branch
  3. Crie um novo branch ou selecione um existente
</Accordion>

O painel Git simplifica o trabalho com múltiplas versões do seu código:

* **Criar branches**: Crie novos branches para desenvolver funcionalidades separadamente
* **Alternar branches**: Mova-se entre diferentes versões do seu código
* **Publicar branches**: Compartilhe seus branches no GitHub
* **Receber alterações**: Sincronize com atualizações remotas de colaboradores

<Frame>
  <img src="https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/gh/pane/08-new-branch.png?fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=a9cab3e787687b8fbbf11103b8b86b20" alt="Painel Git mostrando a interface de criação de branch" width="526" height="83" data-path="images/gh/pane/08-new-branch.png" />
</Frame>

### Resolução de conflitos de mesclagem

<Accordion title="Como resolver conflitos de mesclagem">
  1. Tente receber alterações quando existirem conflitos
  2. O painel Git destacará os arquivos em conflito
  3. Abra cada arquivo em conflito para ver e resolver os conflitos
  4. Salve os arquivos após resolver os conflitos
  5. Conclua a mesclagem selecionando **Pull**
</Accordion>

Quando o código de fontes diferentes entra em conflito, o painel Git ajuda você a:

* **Identificar conflitos**: Veja exatamente quais arquivos contêm conflitos
* **Visualizar diferenças**: Revise ambas as versões do código em conflito
* **Resolver problemas**: Escolha qual código manter ou edite os conflitos manualmente
* **Finalizar mesclagens**: Conclua o processo de mesclagem após resolver os conflitos

<Frame>
  <img src="https://mintcdn.com/replit/rBzGsKp9NcWJ7sib/images/gh/pane/11-merge-conflict.png?fit=max&auto=format&n=rBzGsKp9NcWJ7sib&q=85&s=f02773231068c03053c9c80d75ded53f" alt="Editor de código mostrando marcadores de conflito de mesclagem" width="526" height="108" data-path="images/gh/pane/11-merge-conflict.png" />
</Frame>

Após resolver um arquivo em conflito, você pode remover os marcadores de conflito excluindo as linhas que começam com símbolos de conflito e salvar o arquivo.

### Usando comandos Git no Shell

<Accordion title="Como acessar o Shell">
  1. Selecione **All tools** no dock de ferramentas à esquerda
  2. Selecione **Shell** das ferramentas disponíveis
</Accordion>

<Tip>
  Embora o painel Git ofereça uma interface amigável, usuários avançados podem usar comandos Git padrão no Shell para operações mais complexas. As alterações feitas por qualquer método serão refletidas em ambos os lugares.
</Tip>

Se você preferir usar o Git pela linha de comando:

* **Sincronização de comandos**: Quaisquer comandos Git executados no Shell serão sincronizados automaticamente com o painel Git
* **Funcionalidade Git completa**: Acesse recursos avançados do Git não disponíveis no painel Git
* **Alternância contínua**: Alterne entre usar comandos do Shell e o painel Git conforme necessário

<Info>
  **Suporte ao GitHub e GitLab CLI**: Além dos comandos Git padrão, você também pode usar o [GitHub CLI](https://docs.github.com/en/github-cli) (`gh`) e o [GitLab CLI](https://docs.gitlab.com/ee/editor_extensions/gitlab_cli/) (`glab`) no Shell para gerenciar e conectar a repositórios Git externos. Essas ferramentas fornecem funcionalidade aprimorada para trabalhar com repositórios GitHub e GitLab, incluindo pull requests, issues e outros recursos específicos da plataforma.
</Info>

#### Operações de repositório

* **Clonar repositório**: `git clone <url-to-repository>`
* **Inicializar repositório**: `git init`
* **Adicionar remoto**: `git remote add origin <url-to-repository>`

#### Fazendo alterações

* **Verificar status**: `git status` (mostra arquivos modificados, adicionados e excluídos)
* **Preparar arquivos**: `git add <filename>` ou `git add .` (para todos os arquivos)
* **Confirmar alterações**: `git commit -m "sua mensagem de commit"`
* **Enviar alterações**: `git push origin <branch-name>`
* **Receber alterações**: `git pull origin <branch-name>`

#### Autenticação

Ao trabalhar com repositórios privados, você precisará se autenticar:

* Para repositórios GitHub, use um token de acesso pessoal em vez da sua senha
* Para evitar reinserir credenciais, você pode armazená-las usando Replit Secrets:
  1. Crie um novo secret com a chave `GIT_URL`
  2. Defina o valor como `https://<username>:<token>@github.com/<user-or-org>/<repository>`
  3. Use `git push $GIT_URL` para enviar sem digitar credenciais

<Note>
  Ao usar secrets de credenciais, qualquer pessoa com acesso ao seu App Replit pode potencialmente acessar suas credenciais Git. Para repositórios sensíveis, considere inserir as credenciais manualmente a cada vez.
</Note>