Editar archivos en Workspace
Abre archivos en pestañas, deja que el autoguardado los escriba o guarda de inmediato, entiende qué significa guardado, resuelve un conflicto cuando Codex u otra persona cambió el archivo, y conserva borradores sin guardar entre dispositivos.
- Disponibilidad: Experimental
- Evidencia: Ejecución registrada
- Guía práctica
Antes de empezar
Tu entorno debe estar Listo. Editar necesita un rol que pueda editar el proyecto; un Lector lee.
Abrir archivos
- Abre un archivo desde Archivos, o elige Abrir un archivo y escribe parte de una ruta. Sin nada abierto el editor dice «Ningún archivo abierto».
- Cada archivo es una pestaña. Cada proyecto conserva sus propias pestañas, y están de nuevo allí cuando vuelves, también en otro dispositivo.
- Marca un archivo con la estrella en Archivos para tenerlo en Favoritos.
| Teclas | Acción |
|---|---|
| Ctrl/Cmd+P | Abrir un archivo |
| Ctrl/Cmd+S | Guardar ahora |
| Ctrl/Cmd+W, o Alt+W en un navegador, que se reserva Ctrl/Cmd+W | Cerrar la pestaña |
| Alt+. y Alt+, | Pestaña siguiente y anterior |
Abrir o editar un archivo nunca cambia lo seleccionado para desarrollo.
Guardar, y qué significa «guardado»
El autoguardado escribe un archivo poco después de tu última edición, y Ctrl/Cmd+S lo escribe de inmediato. El estado del archivo dice Guardado, Sin guardar, Guardando, Conflicto o Eliminado en disco, y un guardado se anuncia como «Guardado» con la ruta.
Guardado significa una sola cosa: el archivo está escrito en el almacenamiento de tu entorno. No está confirmado y nadie más lo tiene. Workspace lo dice en Revisión: «Los archivos guardados viven en el almacenamiento de tu entorno. Un punto de control los confirma en tu rama. Integrar los comparte con el proyecto.» Consulta Revisar e integrar cambios.
Un guardado siempre declara la versión del archivo de la que partió. No existe un guardado que sobrescriba a ciegas, y eso es lo que hace posible la sección siguiente.
Cuando el archivo cambió por debajo
Codex edita los mismos archivos que tú, y también puede hacerlo otro de tus dispositivos. Si un archivo cambia en disco:
- sin texto tuyo sin guardar, la pestaña sigue el cambio: «se recargó desde disco»;
- con texto sin guardar, no se sobrescribe nada en ninguno de los dos lados. La pestaña dice Conflicto y «Este archivo cambió en disco mientras tenías texto sin guardar.» y «Tu texto se conserva. No se escribe nada hasta que elijas.»
No hay ninguna opción por defecto:
| Opción | Qué hace |
|---|---|
| Comparar | Muestra dos versiones a la vez: En disco ↔ lo mío, Base ↔ lo mío o Base ↔ en disco. Decidir después lo cierra sin elegir |
| Conservar lo mío | Escribe tu texto sobre la versión que está en disco ahora. Si el archivo cambia otra vez antes, recibes un conflicto nuevo, nunca una sobrescritura silenciosa |
| Tomar lo suyo | Reemplaza tu texto por lo que está en disco |
| Aceptar la eliminación | Cuando el archivo se eliminó: «Este archivo se eliminó en disco mientras tenías texto sin guardar.» |
Mientras hay un conflicto, el autoguardado no escribe ese archivo, y Ctrl/Cmd+S responde «tiene un conflicto. Resuélvelo antes de guardar.» Los mismos bytes escritos por otra persona no son un conflicto. Un archivo que ya no existe dice «ya no existe en disco. Al guardar se crea de nuevo.»
Los borradores te siguen
El texto que no guardaste es un borrador. Se conserva en el dispositivo de inmediato y se envía al servicio, bajo tu cuenta y la de nadie más.
- En otra computadora encuentras las mismas pestañas y el mismo borrador.
- Guardar el archivo descarta su borrador. Nada más quita un borrador: ni detener el entorno, ni perderlo.
- Si el archivo avanzó mientras el borrador esperaba, el borrador vuelve como un conflicto, nunca como una sobrescritura.
| Ves | Significado |
|---|---|
| «Borrador sincronizado» | El servicio lo tiene |
| «Borrador aún sin sincronizar en este dispositivo», y el aviso «Borradores aún sin sincronizar en este dispositivo:» con su cantidad | No se pudo contactar con el servicio. El texto existe solo en este dispositivo hasta que se pueda. Sincronizar ahora lo intenta de nuevo |
| «Este navegador no puede almacenarlos: mantén esta pestaña abierta.» | El navegador rechazó el almacenamiento local, así que el borrador vive solo en la pestaña abierta |
| «Otro dispositivo cambió el borrador de {path}. Se conservan ambas versiones.» | Elige Conservar el de este dispositivo o Usar el otro |
| «Otro dispositivo guardó o descartó el borrador de {path}. El tuyo se conserva.» | Tu texto sigue aquí; decide qué hacer con él |
Un borrador escrito en otro dispositivo no puede mostrar aquí su versión base: «El contenido base no está en este dispositivo: el borrador se escribió en otro. Compara en disco con lo tuyo.»
Con un rol de solo lectura
Un Lector puede abrir el proyecto, leer sus archivos y leer Revisión. Workspace lo dice en un aviso: «Solo lectura.» y «Tu rol en este proyecto puede abrir, leer y revisar. No puede editar, así que nada de lo que escribas se guarda ni se conserva como borrador.» Donde el editor muestra normalmente el retardo del autoguardado, dice «Rol de solo lectura». El texto que se escribe allí no va a ninguna parte: no se escribe, y no es un borrador.
Renombrar y eliminar
En Archivos, Renombrar nunca sobrescribe: «Renombrar nunca sobrescribe un archivo existente.» Eliminar pregunta primero y dice «Su historial sigue en el repositorio.» Ambos se rechazan, con el motivo, para un archivo con texto sin guardar, un archivo que cambió desde que se listó, o una ruta que ya existe; un rechazo no hace nada. Actualizar desde disco lee los archivos de nuevo.
Límites
- El editor comprueba solo la sintaxis de TypeScript. Los imports de módulos de Beyond no se resuelven dentro del editor, así que los errores de significado vienen de la compilación: consulta Diagnósticos, donde se muestran como el texto que entrega Packages, sin una posición a la que saltar.
- El rol de solo lectura se ejecutó en el recorrido de navegador contra el sustituto y en pruebas unitarias, no en el recorrido contra la administración real. El rechazo del servicio a la escritura de un Lector tiene una ejecución registrada de las pruebas del propio servicio.
- No hay terminal.