O editor: abas, modos e edição
Abrir abas, alternar entre fonte, rico e pré-visualização, editar código, localizar e substituir, salvar e autosave.
Abas
- Abrir um arquivo cria uma aba. Abrir outro pela árvore em pré-visualização substitui a aba anterior; abrir em aba permanente mantém a nova ao lado das outras.
- A barra de abas permite fechar, fixar e alternar entre arquivos abertos.
- O mesmo arquivo pode estar aberto em abas diferentes — por exemplo, uma aba de edição e uma de diff. Cada aba guarda o próprio estado de rolagem.
Modos de exibição
O alternador de modos muda o que a aba mostra, e os rótulos dependem do tipo do arquivo:
| Modo | Para quê |
|---|---|
| Fonte | O texto do arquivo, como ele é |
| Rico | Edição de Markdown com formatação |
| Pré-visualização | O resultado renderizado, sem editar |
| Editar | Edição de código (arquivos de código) |
| Alterações | O diff do próprio arquivo, dentro da mesma aba |
Dois detalhes que evitam confusão:
- O modo “Alterações” é ortogonal aos modos de Markdown — ele substitui o conteúdo da aba, não convive com os outros.
- CSV e notebook reutilizam o slot “rico”, com metadados próprios, mas sem edição: ali o modo é tabela ou visualizador, não edição de texto.
Editar código
- O editor de código sincroniza conteúdo, posição do cursor e rolagem.
- Arquivo ou aba somente leitura desabilita a edição.
- Colar conteúdo muito grande pode ser recusado, com aviso de que o texto colado é grande demais.
Localizar, substituir e buscar no projeto
| Ação | Atalho | Observação |
|---|---|---|
| Localizar | atalho de busca do editor | Usa a busca nativa do editor |
| Substituir | atalho próprio de substituição | Também no editor |
| Buscar no projeto | menu de contexto do editor | Usa a seleção ou a posição do cursor como consulta e abre a busca lateral |
- Repetições do atalho de localizar não reabrem a busca: elas são consumidas para não interferir no que já está aberto.
- Buscar no projeto sem consulta derivável não faz nada — se não houver seleção nem palavra sob o cursor, não há o que buscar.
Copiar referência de linha
O menu do gutter do editor copia o caminho com o número da linha do cursor, em duas formas: caminho absoluto e caminho relativo. É o formato prático para apontar um ponto exato do código numa mensagem para o agente ou numa issue.
Renomear pelo cabeçalho
O cabeçalho do editor tem um menu do caminho com a ação renomear, que abre um campo inline:
- Enter confirma, Escape cancela, sair do campo confirma.
- A ação só existe quando o arquivo pode ser renomeado.
- Abas virtuais não oferecem renomear — elas não correspondem a um arquivo no disco.
Renomear aqui é a mesma operação de renomear na árvore: o arquivo muda de nome no disco.
Salvar e autosave
- Salvar tem atalho próprio e funciona em qualquer aba editável.
- Autosave grava sozinho depois de um intervalo, mas não vale para toda aba:
- abas de edição e diffs não preparados de um arquivo podem ter autosave;
- abas de diff combinado e de revisão de conflito não têm autosave;
- o autosave é suspenso quando o arquivo mudou no disco por fora do app ou quando a base de comparação não foi verificada.
- Arquivos novos não intitulados são escritos no disco já na criação, e o nome é definido depois.
Limites
- O editor não cria cópia de segurança própria: o que protege seu trabalho é o git e o autosave.
- Colar e abrir arquivos muito grandes têm limites; não há promessa de abrir qualquer tamanho.
- O autosave não substitui o
commit.