---
id: "arquivos-editor"
titulo: "El editor: pestañas, modos y edición"
resumo: "Abrir pestañas, alternar entre fuente, rico y vista previa, editar código, buscar y reemplazar, guardar y autoguardado."
idioma: "es"
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/es/ferramentas/arquivos/editor/"
fonte: "pt-br/ferramentas/arquivos/editor.md"
caminhoPublico: "docs/publica/es/ferramentas/arquivos/editor.md"
hashFonte: "sha256:73434e46ea265427466e6bb11109f119d3ac94aa75dd36634915dfd7797f4286"
hashDestaPagina: "sha256:fa7e70fe755dbb2e14027bcf963f862a32381e3df1660fa24d3e0d5ad958c19d"
traducaoAssistidaPorIA: true
traducaoDesatualizada: false
corpoRetido: false
---
<!-- traducao-assistida-por-ia: idioma=ES fonte=pt-br/ferramentas/arquivos/editor.md fonteHash=sha256:73434e46ea265427466e6bb11109f119d3ac94aa75dd36634915dfd7797f4286 estado=atual -->

## Pestañas

- Abrir un archivo crea una pestaña. Abrir otro desde el árbol en **vista previa** sustituye la pestaña anterior; abrir como **pestaña permanente** mantiene la nueva junto a las otras.
- La barra de pestañas permite cerrar, fijar y alternar entre archivos abiertos.
- **El mismo archivo puede estar abierto en pestañas diferentes** — por ejemplo, una pestaña de edición y una de diff. Cada pestaña guarda su propio estado de desplazamiento.

## Modos de visualización

El alternador de modos cambia lo que muestra la pestaña, y los rótulos dependen del tipo del archivo:

| Modo | Para qué |
|---|---|
| **Fuente** | El texto del archivo, tal como es |
| **Rico** | Edición de Markdown con formato |
| **Vista previa** | El resultado renderizado, sin editar |
| **Editar** | Edición de código (archivos de código) |
| **Cambios** | El diff del propio archivo, dentro de la misma pestaña |

Dos detalles que evitan confusión:

- **El modo "Cambios" es ortogonal a los modos de Markdown** — sustituye el contenido de la pestaña, no convive con los otros.
- **CSV y notebook reutilizan el slot "rico"**, con metadatos propios, pero sin edición: allí el modo es tabla o visor, no edición de texto.

## Editar código

- El editor de código sincroniza contenido, posición del cursor y desplazamiento.
- **Un archivo o pestaña de solo lectura** desactiva la edición.
- Pegar contenido muy grande puede rechazarse, con aviso de que el texto pegado es demasiado grande.

## Buscar, reemplazar y buscar en el proyecto

| Acción | Atajo | Observación |
|---|---|---|
| **Buscar** | el atajo de búsqueda del editor | Usa la búsqueda nativa del editor |
| **Reemplazar** | su propio atajo de reemplazo | También en el editor |
| **Buscar en el proyecto** | el menú de contexto del editor | Usa la **selección** o la posición del cursor como consulta y abre la búsqueda lateral |

- Las repeticiones del atajo de búsqueda **no reabren** la búsqueda: se consumen para no interferir con lo que ya está abierto.
- **Buscar en el proyecto sin consulta derivable no hace nada** — si no hay selección ni palabra bajo el cursor, no hay nada que buscar.

## Copiar referencia de línea

El menú del gutter del editor copia la ruta **con el número de línea** del cursor, en dos formas: ruta absoluta y ruta relativa. Es el formato práctico para apuntar a un punto exacto del código en un mensaje para el agente o en una issue.

## Renombrar desde el encabezado

El encabezado del editor tiene un menú de la ruta con la acción **renombrar**, que abre un campo en línea:

- **Enter** confirma, **Escape** cancela, salir del campo confirma.
- La acción solo existe cuando el archivo puede renombrarse.
- **Las pestañas virtuales no ofrecen renombrar** — no corresponden a un archivo en el disco.

Renombrar aquí es la misma operación que renombrar en el árbol: el archivo cambia de nombre en el disco.

## Guardar y autoguardado

- **Guardar** tiene atajo propio y funciona en cualquier pestaña editable.
- **El autoguardado** escribe solo tras un intervalo, pero **no vale para toda pestaña**:
  - las pestañas de edición y los diffs no preparados de un archivo **pueden** tener autoguardado;
  - **las pestañas de diff combinado y de revisión de conflicto no tienen autoguardado**;
  - el autoguardado se **suspende** cuando el archivo cambió en el disco fuera de la app o cuando la base de comparación no fue verificada.
- **Los archivos nuevos sin título** se escriben en el disco ya en la creación, y el nombre se define después.

## Límites

- El editor **no** guarda copia de seguridad propia: lo que protege tu trabajo es git y el autoguardado.
- Pegar y abrir archivos muy grandes tienen límites; no hay promesa de abrir cualquier tamaño.
- El autoguardado no sustituye un `commit`.

## Relacionados

- [Abrir y visualizar archivos](/docs/es/ferramentas/arquivos/abrir-e-visualizar/)
- [Markdown: modos, formato y notas](/docs/es/ferramentas/arquivos/markdown/)