---
title: Inspecionar e editar código da loja
description: Abra o editor de código condicional do Runner, salve uma alteração de arquivo focada, revise as alterações Git e evite perder trabalho não salvo.
---

O editor de código permite inspecionar ou fazer uma alteração focada nos arquivos da loja por trás da visualização atual. Use-o apenas quando uma edição visual ou solicitação do Runner não for a melhor opção.

## O que este guia cobre

Abra o editor de código condicional, salve uma alteração de arquivo focada, retorne à Preview para verificá-la e mantenha commit, push e publicação como ações deliberadas separadas.

## Caminho de entrada

Abra um projeto de loja → **Vitrine** → **Abrir editor de código**.

## Antes de começar

- Aguarde até que o workspace do projeto e a visualização da loja estejam conectados.
- Use o editor de código apenas se você entender o arquivo que pretende alterar.
- Salve cada arquivo alterado antes de fechar sua aba ou o diálogo. Fechar um arquivo não salvo não mostra uma confirmação.
- Um arquivo salvo altera o workspace do projeto, mas não é automaticamente feito commit, enviado, publicado ou comprovado como correto em Preview.
- Use **Confirmar** e **Enviar** apenas quando você estiver autorizado a alterar o Git remoto configurado do projeto.

## Controles do editor e resultados de clique

| Controle ou estado | O que acontece depois que você o usa |
| --- | --- |
| **Abrir editor de código** | Abre o diálogo **Editor de código** em altura total. Fechar o diálogo retorna o painel Vitrine à Visualização. |
| Ícone de arquivos | Mostra a árvore de arquivos da loja pesquisável. Expandir uma pasta carrega seu conteúdo; selecionar um arquivo o abre em uma aba. |
| Aba de arquivo | Alterna o editor para esse arquivo aberto. Um ponto laranja significa que a aba contém alterações não salvas. |
| Ícone de fechar em uma aba de arquivo | Fecha essa aba. Runner não pergunta sobre alterações não salvas, então salve primeiro. |
| Editor de código | Permite alterar o arquivo ativo. Digitar altera a aba aberta, mas não salva o arquivo automaticamente. |
| **Command-S** no macOS ou **Control-S** no Windows/Linux | Salva o arquivo ativo no workspace do projeto conectado. O indicador não salvo laranja desaparece após o sucesso. |
| Ícone de branch Git | Abre o branch atual, listas de arquivos alterados, formulário de commit e controles de push. Selecionar um arquivo alterado abre seu diff. |
| **Stage** / **Unstage** | Adiciona ou remove um arquivo do próximo commit. Não salva uma aba do editor não salva. |
| **Preparar tudo** / **Desfazer preparação** | Aplica a mesma escolha de staging a cada arquivo na lista correspondente. Revise a lista antes de usar qualquer ação. |
| **Mensagem de commit** | Registra a explicação que será anexada ao próximo commit. |
| **Confirmar** | Cria um commit a partir de arquivos em staging quando a mensagem não está vazia. Alterações não em staging e não salvas permanecem fora desse commit. |
| **Enviar** | Envia imediatamente commits que estão à frente do remoto configurado. Não há segunda confirmação neste painel. |
| **Atualizar** | Solicita o status Git mais recente para o workspace do projeto conectado. |

## Faça e verifique uma edição focada

1. Confirme o nome do projeto e a loja atual em Preview.
2. Selecione **Abrir editor de código**.
3. Mantenha a visualização de Arquivos aberta, expanda a pasta necessária e selecione um arquivo.
4. Leia o conteúdo existente antes de alterá-lo.
5. Faça a menor edição pretendida.
6. Pressione **Command-S** ou **Control-S** e confirme se o ponto laranja desaparece.
7. Feche o editor de código e revise a página afetada em Preview.
8. Verifique os layouts de desktop e celular quando a alteração puder afetar qualquer um deles.
9. Se o resultado estiver errado, retorne ao editor e corrija-o, ou peça ao Runner para reparar o arquivo específico e o problema visível.

Salvar prova apenas que Runner escreveu o arquivo. Preview prova apenas que o projeto atual pode exibi-lo. Publicação e a jornada do cliente ao vivo permanecem como verificações separadas.

## Faça commit e push apenas quando necessário

1. Salve cada arquivo que pretende incluir.
2. Abra a visualização de branch Git.
3. Selecione cada arquivo alterado e revise seu diff.
4. Use **Preparar** para os arquivos pretendidos. Evite **Preparar tudo** quando houver alterações não relacionadas.
5. Insira uma **Mensagem de commit** clara.
6. Selecione **Confirmar** e aguarde o status Git ser atualizado.
7. Use **Enviar** apenas após confirmar o branch e o fluxo de trabalho remoto. A ação inicia imediatamente.
8. Retorne à Preview e verifique o resultado visível. Um commit ou push bem-sucedido não publica a loja.

## Solução de problemas

| Estado | Significado | O que fazer |
| --- | --- | --- |
| **Abrir editor de código** está ausente | O recurso não está habilitado para este projeto. | Use o Modo de Design ou peça ao Runner para fazer a alteração. Não confie em uma rota interna copiada. |
| **Conectando ao sandbox...** | O workspace do projeto ainda não está conectado. | Mantenha o projeto aberto e tente novamente após o workspace se reconectar. |
| Spinner de árvore de arquivos | Runner está carregando a pasta atual. | Aguarde antes de selecionar outra pasta repetidamente. |
| Selecionar um arquivo não faz nada | O arquivo não pôde ser lido ou o workspace foi desconectado. | Verifique a conexão e selecione o arquivo novamente. |
| Ponto laranja permanece após salvar | O arquivo não foi salvo com sucesso. | Mantenha a aba aberta, leia a mensagem de erro e tente novamente após se reconectar, se necessário. |
| **Abrir um arquivo da árvore** | Nenhum arquivo está ativo. | Selecione um arquivo na visualização de Arquivos. |
| **Sem alterações** | Git não relata alterações de arquivo salvo. | Salve a aba do editor e selecione **Atualizar**. |
| **Confirmar** está desabilitado | Nenhum arquivo em staging ou nenhuma mensagem de commit está presente. | Faça staging do arquivo salvo pretendido e insira uma mensagem. |
| **Enviar** está desabilitado | O branch não tem commit local à frente do remoto, ou um push está em execução. | Faça commit da alteração pretendida ou aguarde o push atual. |
| **Falha ao carregar o status do git** | O Runner não pôde ler o estado do repositório. | Selecione **Tentar novamente**. Não faça staging ou push até que o status seja carregado. |
| A contagem de seta para baixo mostra que o branch está atrás | O remoto contém commits não presentes no workspace. | Pare antes de fazer push e peça ao proprietário do projeto como atualizar o branch com segurança. |
| Erro de salvar, fazer staging, fazer commit ou fazer push | A ação não foi concluída. | Mantenha o estado atual, leia o erro e tente novamente apenas após verificar a conexão e permissão. |

## Guias relacionados

- [Visualizar sua loja](./preview-your-store)
- [Usar o Modo de Design](./design-mode)
- [Usar o histórico de versões](./version-history)
- [Publicar e republicar](./publish-and-republish)
- [Solucionar problemas de visualização e publicação](./troubleshoot-preview-and-publishing)