Inspecionar e editar código da loja

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

Confirme o nome do projeto e a loja atual em Preview.
Selecione Abrir editor de código.
Mantenha a visualização de Arquivos aberta, expanda a pasta necessária e selecione um arquivo.
Leia o conteúdo existente antes de alterá-lo.
Faça a menor edição pretendida.
Pressione Command-S ou Control-S e confirme se o ponto laranja desaparece.
Feche o editor de código e revise a página afetada em Preview.
Verifique os layouts de desktop e celular quando a alteração puder afetar qualquer um deles.
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

Salve cada arquivo que pretende incluir.
Abra a visualização de branch Git.
Selecione cada arquivo alterado e revise seu diff.
Use Preparar para os arquivos pretendidos. Evite Preparar tudo quando houver alterações não relacionadas.
Insira uma Mensagem de commit clara.
Selecione Confirmar e aguarde o status Git ser atualizado.
Use Enviar apenas após confirmar o branch e o fluxo de trabalho remoto. A ação inicia imediatamente.
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.