# Git pull recusado no cPanel após editar arquivo no servidor

A sequência no cPanel para ver o que foi editado direto no servidor, guardar ou descartar a alteração, e voltar ao commit anterior quando a publicação derrubou a página.

> o pull é recusado porque existem alterações não comitadas no servidor, quase sempre uma edição feita pelo Gerenciador de Arquivos. Rode `git status` e `git diff` para ver o que mudou, guarde com `git stash` ou descarte com `git checkout -- arquivo`, e só então puxe de novo.

João Rizzon · 2026-10-21 · Painéis

---

## O que a mensagem "local changes would be overwritten by merge" significa

A mensagem completa é esta:

```
error: Your local changes to the following files would be overwritten by merge:
	wp-config.php
	wp-content/themes/meu-tema/functions.php
Please commit your changes or stash them before you merge.
Aborting
```

Tradução prática: no diretório do site, dentro do servidor, existem arquivos que foram alterados depois do último commit. O Git percebeu que o conteúdo novo que viria do repositório remoto tocaria exatamente esses arquivos. Em vez de sobrescrever e apagar o que alguém escreveu ali, ele para tudo e não faz nada.

Isso é proteção, não defeito. O pull foi abortado por inteiro: nenhum arquivo foi atualizado, nada ficou pela metade. O site continua rodando a versão antiga.

Na prática quase sempre o culpado é o mesmo: alguém abriu o **Gerenciador de Arquivos** do cPanel e editou `wp-config.php` para trocar credencial de banco, ou mexeu no `functions.php` do tema para resolver um problema rápido, ou um plugin gravou algo dentro de uma pasta versionada. Edição feita pelo navegador é alteração local igual a qualquer outra, só que ninguém registrou em commit.

Um detalhe sobre o `wp-config.php` da mensagem acima: ele só aparece nessa lista quando foi versionado por engano. O lugar dele é no `.gitignore`, porque guarda credencial de produção. Enquanto ele estiver sob controle de versão, trate-o como qualquer outro arquivo deste artigo e, passada a urgência, tire-o do versionamento (a seção sobre `.gitignore` mostra como conferir).

## Baixe o backup antes, porque git checkout não tem desfazer

Todo comando deste artigo que resolve o travamento descarta ou move alteração. `git checkout -- arquivo` apaga o trabalho não comitado sem lixeira e sem confirmação.

Faça o backup pelo cPanel antes de abrir o terminal:

- No cPanel, seção **Arquivos**, abra **Backup** (ou **Assistente de Backup**).
- Clique em **Baixar um Backup do Diretório Base** (Download a Home Directory Backup) e espere o arquivo `.tar.gz` chegar no seu computador.
- Se o site tem banco, desça até **Baixar um Backup de Banco de Dados MySQL** e baixe também.

Se o backup completo demora demais, no mínimo copie os arquivos citados no erro: no **Gerenciador de Arquivos**, clique com o botão direito no arquivo, escolha **Copiar** e salve como `wp-config.php.antes` fora da pasta do repositório, por exemplo direto em `/home/usuario/`. Fora da pasta do repositório é importante: cópia dentro dele vira mais um arquivo não rastreado para atrapalhar depois.

## Por que o Git™ Version Control não resolve isso e o terminal resolve

O painel do cPanel tem **Git™ Version Control** em **Arquivos**, e é por ele que se vê a lista de repositórios, o caminho de cada um e os botões de pull e deploy. O que ele não tem é tela para resolver conflito. Isso é no terminal.

### Encontre o caminho do repositório no Git™ Version Control

Abra **Git™ Version Control**, localize o repositório do site e anote o valor do campo de caminho, algo como `/home/usuario/repositories/meusite`. Esse é o diretório onde os comandos precisam rodar.

### Abra o Terminal do cPanel ou conecte por SSH

Na seção **Avançado**, clique em **Terminal** e aceite o aviso inicial. Se o ícone não existir na sua conta, use SSH com o mesmo usuário do cPanel.

### Entre na pasta e confirme que ela tem um diretório .git

```
cd ~/repositories/meusite
```

Confirme que está no lugar certo:

```
pwd
ls -a
```

O `pwd` devolve o caminho atual. O `ls -a` precisa mostrar uma pasta `.git` na listagem. Se não mostrar, você não está na raiz do repositório e nenhum comando de Git vai funcionar ali.

## Leia git status e git diff antes de apagar qualquer coisa

A documentação do cPanel sobre comandos comuns do Git trata `git status` como o ponto de partida: ele lista arquivos alterados e arquivos não rastreados no diretório de trabalho.

```
git status
```

Exemplo de retorno (fictício, só para ilustrar o formato):

```
On branch main
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
	modified:   wp-config.php
	modified:   wp-content/themes/meu-tema/functions.php

Untracked files:
	wp-content/uploads/2026/relatorio.pdf
```

Depois veja **o que** mudou dentro de cada arquivo:

```
git diff wp-content/themes/meu-tema/functions.php
```

Linhas começando com `-` são as que existem no commit e sumiriam. Linhas com `+` são o que está no servidor agora. É aqui que você descobre se a edição local era o ajuste que colocou o site de pé (preciosa) ou um teste esquecido (descartável). Para sair da tela de diff, aperte `q`.

## Descartar, guardar ou comitar: qual das três saídas usar

| Situação do arquivo editado no servidor | Comando | O que acontece |
|---|---|---||
| Alteração sem valor, pode sumir | `git checkout -- arquivo` | Descarta de vez e devolve a versão do último commit |
| Quero guardar sem decidir agora | `git stash` | Move as alterações para uma pilha temporária e limpa o diretório |
| A alteração é boa e deve virar histórico | `git add` + `git commit` | Vira commit local e o merge passa a ser possível |

### Descartar a edição com git checkout e perder o conteúdo

```
git checkout -- wp-content/themes/meu-tema/functions.php
git status
```

O `git status` depois precisa deixar de citar aquele arquivo. Não há desfazer: o conteúdo editado no Gerenciador de Arquivos desaparece. Só use depois de ler o `git diff` e com o backup já baixado.

### Guardar a edição na pilha com git stash, que não é backup

```
git stash
git stash list
```

O `git stash` tira as alterações do caminho e guarda em uma pilha. O `git stash list` mostra entradas como `stash@{0}: WIP on main: a1b2c3d ajuste no header`. Com o diretório limpo, o pull passa.

Para trazer de volta depois:

```
git stash pop
```

**Stash não é backup.** Ele vive dentro do `.git` daquele repositório, naquele servidor. Se o repositório for recriado, se a conta for migrada, ou se alguém apagar a pasta, a pilha vai junto. O backup é o `.tar.gz` que você baixou.

### Transformar a edição do servidor em commit com git add e git commit

Quando a alteração feita direto no servidor é legítima:

```
git add wp-content/themes/meu-tema/functions.php
git commit -m "Corrige hook do tema editado direto no servidor"
```

O `git add` seleciona o arquivo e o `git commit` grava. A partir daí o Git tem duas versões para comparar e o merge acontece normalmente, podendo pedir resolução de conflito se a mesma linha mudou dos dois lados.

### Rodar o pull de novo pelo painel ou pelo terminal

Com o diretório limpo, volte ao **Git™ Version Control** do cPanel, abra a aba de pull e deploy do repositório e peça a atualização a partir do remoto. Ou, no terminal:

```
git pull
```

O retorno esperado cita os arquivos atualizados e um resumo de inserções e remoções. Se a conta usa `.cpanel.yml`, o deploy copia os arquivos para o diretório público depois disso.

## Voltar ao commit anterior quando a publicação quebrou a página

Se o site caiu com a última publicação, o objetivo muda: não é resolver o pull, é colocar a página no ar de novo.

### Encontre o commit anterior com git log --oneline

```
git log --oneline -n 10
```

Saída no formato `a1b2c3d Mensagem do commit`, do mais recente para o mais antigo. Anote o identificador curto do commit anterior ao que quebrou.

Antes de executar o próximo passo, entenda o risco: trocar para um commit antigo e fazer deploy publica a versão antiga do site para os visitantes. Alterações feitas no site depois daquele commit (um ajuste de tema, uma correção de código) somem da página no ar até você voltar. Conteúdo e banco não são afetados, só os arquivos versionados. Para desfazer, você roda `git checkout main` e faz o deploy de novo, e o site volta ao estado da última publicação.

### Troque para o commit antigo e entenda o detached HEAD

```
git checkout a1b2c3d
```

O Git avisa que você está em **detached HEAD**: os arquivos são os daquele commit, mas você não está em nenhum branch. Para conferir no site, faça o deploy e abra a página, lembrando que esse deploy é visível para quem acessa. Se o resultado não for o esperado, volte com `git checkout main` e repita o deploy.

### Volte para main ou master e conserte no repositório remoto

```
git checkout main
```

Troque `main` por `master` se for o nome do seu branch. Em detached HEAD o `git status` não ajuda nisso: ele responde `HEAD detached at a1b2c3d`. Descubra o nome antes do checkout do commit antigo, com:

```
git branch -a
```

O retorno lista os branches locais e os remotos, um por linha, com um asterisco no branch atual, algo como `* main` e `remotes/origin/main`. O mesmo nome aparece no campo de branch do repositório dentro do **Git™ Version Control**, no cPanel. Enquanto o site estiver no commit antigo, o conserto definitivo é no repositório remoto: corrija lá, comite, e puxe de novo. Deixar o servidor parado em detached HEAD por tempo indeterminado é convite para o próximo pull falhar de um jeito novo.

## O que o git status não mostra: arquivos ignorados e não rastreados

Dois pontos cegos derrubam quem está resolvendo o problema às pressas.

**Arquivo nunca versionado não aparece como modificado.** Se `wp-config.php` está listado no `.gitignore` (é o que recomendamos, por causa das credenciais), ele nunca entra no `git status` como alterado e nenhum pull vai sobrescrevê-lo. Se ele apareceu na mensagem de erro, é porque foi versionado antes de entrar no `.gitignore`. Confirme com:

```
cat .gitignore
```

**Uploads e plugins instalados pelo painel do WordPress** costumam aparecer em *Untracked files* e não bloqueiam o pull, mas também não voltam sozinhos se a pasta for recriada. Mídia e banco são responsabilidade do backup, não do Git.

## Rotina que evita o próximo pull travado

- Edite tema e plugin no repositório, comite e puxe. O Gerenciador de Arquivos fica para leitura e emergência.
- Quando a emergência obrigar a editar no servidor, volte no mesmo dia e transforme aquilo em commit, enquanto você ainda lembra o motivo.
- Mantenha `wp-config.php` fora do versionamento, via `.gitignore`, para que credencial de produção e repositório nunca disputem a mesma linha.
- Antes de cada deploy maior, baixe o backup do diretório base. É o único passo da lista que funciona mesmo quando todo o resto falha.

Fonte dos comandos de Git usados aqui (`status`, `diff`, `stash`, `add`, `commit`, `checkout`, `pull`): [Guide to Git: Common Git Commands, documentação oficial do cPanel](https://docs.cpanel.net/knowledge-base/web-services/guide-to-git-common-git-commands/), consultada em 20/10/2026. A navegação pelo painel descrita no texto (Terminal, Backup, abas de pull e deploy do Git™ Version Control) é descrição da interface do cPanel conforme ela aparece na tela, não conteúdo daquela página de documentação, e os nomes dos menus mudam de versão para versão. Os retornos de tela deste artigo são exemplos ilustrativos, não medições.

