Formateo

Formatear un documento #

1. Abre un archivo de proyecto en fuente y pulsa Alt+Shift+F o Formatear documento en la paleta.
2. OEC elige byExtension o defaultFormatter. Si es none no formatea; si es prettier pasa el contenido, filepath y opciones configuradas.
3. Aplica el resultado solo si ruta y contenido siguen coincidiendo al terminar. Guarda después con Ctrl+S.

Opciones y formato al guardar #

Los defaults usan Prettier para JavaScript, TypeScript, JSON, CSS, HTML, SVG, Markdown y YAML. SVG fuerza el parser HTML para tratarlo como markup. Hay cinco opciones expuestas: printWidth, tabWidth, useTabs, semi y singleQuote.

formatOnSave se aplica en el guardado normal, solo a archivos del proyecto en fuente. Un error del formateador no impide que ese guardado continúe. Las rutas de confirmación al cerrar/salir omiten el formateo.

Registrar un formateador externo #

Se declara únicamente en global. El proceso recibe texto por stdin y debe devolver el documento completo por stdout; stderr sirve para diagnóstico. Se ejecuta sin shell, con timeout, heredando entorno y cwd del proceso.

• Asocia .txt a myFormatter en editor.formatting.byExtension global. La lista extensions del ejecutable debe admitir esa extensión.
• Los cuatro campos son obligatorios. No hay interpolación automática de rutas ni sandbox. No declara nuevos comandos de paleta.

"formatters": {
  "external": {
    "myFormatter": {
      "command": "my-formatter",
      "args": ["--stdin"],
      "extensions": [".txt"],
      "timeoutMs": 5000
    }
  }
}