Si un proyecto necesita un formateador de código diferente, establezca la opción a nivel de proyecto: use el archivo de configuración de dicho proyecto y, si trabaja en Visual Studio Code, la configuración de su espacio de trabajo. Esto mantiene intactos los valores predeterminados de usuario de VS Code a la vez que hace reproducible la elección del formateador del proyecto. Los pasos siguientes se centran en macOS y VS Code; otros editores pueden utilizar controles diferentes.

Decida qué significa «formateador» para este proyecto

Primero identifique el lenguaje y la necesidad real. Un formateador reescribe el código adaptándolo a un estilo; un ajuste básico del editor puede controlar únicamente la sangría, los saltos de línea o los espacios en blanco. Por ejemplo, EditorConfig proporciona propiedades de estilo del proyecto que los editores compatibles pueden leer, mientras que Prettier es un formateador con su propia configuración de proyecto. Estas herramientas pueden complementarse entre sí, pero un archivo EditorConfig por sí solo no selecciona ni instala un formateador. EditorConfig describe su formato y sus complementos para editores; la guía de configuración de Prettier explica cómo lee los archivos de configuración admitidos.

Compruebe qué formateador utiliza ya el proyecto antes de añadir otro. Revise el manifiesto de paquetes, la configuración del formateador y la documentación del proyecto. Si los miembros del equipo o las comprobaciones automatizadas esperan una herramienta o versión específica, ajustarse a esa configuración suele ser la opción más práctica. Instalar un formateador alternativo o cambiar sus opciones puede generar diferencias (diffs) extensas incluso cuando el código siga funcionando.

Elija a dónde pertenece el ajuste

En VS Code, la configuración de usuario se aplica a todo el uso que haga del editor, mientras que la configuración del espacio de trabajo se aplica al proyecto abierto y tiene prioridad sobre la configuración de usuario. VS Code guarda la configuración del espacio de trabajo en una carpeta .vscode en la raíz del proyecto; la configuración de usuario se almacena por separado en el directorio de soporte de aplicaciones de su cuenta de macOS. Utilice la paleta de comandos (⇧⌘P) y elija Preferences: Open Workspace Settings (JSON) para editar la configuración del proyecto. Confirme que el editor de configuración muestre Workspace antes de realizar cualquier cambio. La documentación sobre configuración de VS Code explica los ámbitos y las ubicaciones.

Para seleccionar un formateador solo para un lenguaje en este proyecto, añada una entrada de formateador predeterminado específica para ese lenguaje en la configuración del espacio de trabajo. Por ejemplo, si el proyecto utiliza la extensión de Prettier para VS Code con JavaScript, la configuración tendrá esta estructura:

{
  "[javascript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  }
}

Utilice el identificador de extensión correspondiente al formateador realmente instalado en su editor; el ejemplo no es un identificador universal. Si el proyecto incluye varios lenguajes, añada una entrada para cada lenguaje relevante en lugar de establecer un valor predeterminado global. El comando Format Document With... de VS Code le permite elegir entre los formateadores disponibles para el documento actual, y sus acciones de formateo se pueden invocar desde la paleta de comandos. La guía de formateo de VS Code documenta dichos controles. Evite habilitar la opción de formatear al guardar (format-on-save) como parte de este cambio puntual a menos que desee que cada guardado en ese proyecto active el formateo.

Mantenga las reglas del formateador con el proyecto

Un formateador predeterminado selecciona una herramienta; no define todas las reglas de formato de dicha herramienta. Guarde las reglas compartidas en un archivo de configuración que el formateador elegido reconozca. Para Prettier, podría tratarse de un archivo .prettierrc.json en la raíz del proyecto. Un ejemplo mínimo podría especificar únicamente las opciones que el proyecto ha acordado utilizar:

{
  "singleQuote": true
}

Prettier busca la configuración desde el archivo que se está formateando hacia arriba a través de sus directorios principales, por lo que una configuración a nivel de raíz puede aplicarse a los archivos que se encuentren debajo de ella. También admite varios formatos de configuración adicionales; elija uno compatible con la versión y las herramientas existentes del proyecto. La documentación de configuración de Prettier enumera los archivos admitidos y el comportamiento de resolución.

Si el objetivo es solo lograr una sangría o unos saltos de línea coherentes en distintos editores, considere usar un .editorconfig en la raíz en su lugar. Por ejemplo, root = true detiene la búsqueda de archivos EditorConfig en niveles superiores, y propiedades como indent_style, indent_size y end_of_line pueden definir convenciones de texto básicas. El soporte del editor varía según el plugin, y estas propiedades no reemplazan las reglas de formateo específicas para cada lenguaje. La especificación y descripción general de EditorConfig describen cómo se localizan los archivos y cómo se aplican las reglas coincidentes.

Verifique el ámbito antes de formatear

Guarde la configuración del espacio de trabajo y el archivo de configuración, y luego vuelva a abrir la carpeta del proyecto en VS Code si es necesario. Abra un archivo representativo y utilice Format Document With... para confirmar el formateador seleccionado. Si el formateador no aparece en la lista, compruebe que su extensión esté instalada y sea compatible con ese lenguaje; una configuración del espacio de trabajo no puede instalar una extensión ni añadir soporte para un formateador por sí misma.

Antes de aplicar el formateo de forma generalizada, inspeccione los archivos afectados en Source Control o en una vista de diferencias. Formatee primero un conjunto pequeño y representativo, especialmente si el proyecto cuenta con reglas de estilo preexistentes o archivos generados. Si el resultado es inesperado, deténgase y compruebe si existe una configuración en conflicto en un directorio superior, un ajuste específico para el lenguaje u otro formateador que el proyecto ya espere utilizar. Revierta los cambios de formato no deseados mediante las herramientas de control de código fuente del editor, ajuste la configuración del proyecto y repita la prueba en un conjunto pequeño.

Esto mantiene la decisión vinculada al proyecto: los valores predeterminados de usuario de VS Code permanecen en su ámbito independiente, mientras que el proyecto puede conservar su propia selección de formateador y sus reglas. Si cambia de editor, la configuración del espacio de trabajo no se transferirá, por lo que dependerá de la configuración del proyecto del formateador cuando dicho editor la admita.

Fuentes