---
id: "arquivos-editor"
titulo: "O editor: abas, modos e edição"
resumo: "Abrir abas, alternar entre fonte, rico e pré-visualização, editar código, localizar e substituir, salvar e autosave."
idioma: "pt-br"
tipo: "guia"
categoria: "arquivos-git"
aplicavelDesde: "0.0.16"
capabilities: ["editor.open.tabs", "editor.edit.code", "editor.find.replace", "editor.searchInFiles", "editor.copyPathToLine", "editor.renameFile"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/ferramentas/arquivos/editor/"
fonte: "pt-br/ferramentas/arquivos/editor.md"
caminhoPublico: "docs/publica/pt-br/ferramentas/arquivos/editor.md"
hashFonte: "sha256:73434e46ea265427466e6bb11109f119d3ac94aa75dd36634915dfd7797f4286"
hashDestaPagina: "sha256:73434e46ea265427466e6bb11109f119d3ac94aa75dd36634915dfd7797f4286"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
## 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`.

## Relacionados

- [Abrir e visualizar arquivos](/docs/pt-br/ferramentas/arquivos/abrir-e-visualizar/)
- [Markdown: modos, formatação e notas](/docs/pt-br/ferramentas/arquivos/markdown/)