Domina el formateo de código con dart format

Estandarización de código con dart format

dart format es la herramienta oficial para imponer un estilo de código uniforme y opinado. Esto significa que no puedes configurar si prefieres espacios o tabulaciones, ni dónde colocar las llaves; el formateador ya ha decidido qué es lo mejor para que tú y tu equipo dejen de perder tiempo discutiendo sobre estética en los code reviews. Su lógica interna es idempotente: si ejecutas el comando sobre un archivo que ya tiene el estilo correcto, no se producirá ningún cambio. Debes usarlo siempre antes de hacer un commit, integrarlo en tu flujo de CI (Integración Continua) con el flag --set-exit-if-changed para asegurar la consistencia en el repositorio, o incluso configurarlo en tu IDE para que se ejecute automáticamente al guardar. Si ignoras esta herramienta, tu historial de Git se llenará de cambios de formato irrelevantes, dificultando la lectura de cambios reales en la lógica del programa.

Para probarlo, puedes ejecutar dart format archivo.dart para formatear un archivo específico, o dart format . para formatear todo el directorio actual de forma recursiva. Si solo quieres ver qué cambios haría sin aplicarlos realmente, utiliza dart format --output show ..

void main() {
  // Sin coma final: el formateador lo mantiene en una sola línea.
  var colores = ['rojo', 'verde', 'azul'];

  // Con coma final: el formateador aplica la expansión vertical.
  var coordenadas = [
    10.5,
    20.3,
    5.0,
  ];

  // Parámetros comprimidos si no hay comas finales.
  configurarServidor('localhost', 8080, 'production');

  // Parámetros expandidos si se usan comas finales (trailing commas).
  configurarServidor(
    '127.0.0.1',
    3000,
    'development',
  );
}

void configurarServidor(String host, int puerto, String modo) {
  print('Servidor en $host:$puerto modo $modo');
}

En el ejemplo anterior, observa cómo interactúa la herramienta con la estructura de tus datos. En la variable colores, como no hay una coma después de 'azul', el formateador mantiene la lista en una sola línea para ahorrar espacio. Sin embargo, en coordenadas, la presencia de la trailing comma (la coma después de 5.0) le indica explícitamente al formateador que deseas que cada elemento ocupe su propia línea, facilitando la lectura en listas largas.

Lo mismo sucede con la función configurarServidor. Cuando la llamas con los argumentos en una sola línea, el formateador intenta comprimirla. Pero si añades una coma tras el último argumento ('development',), el motor de dart format expande los parámetros verticalmente. Esto es una técnica fundamental para mantener los diffs de Git limpios: al añadir un nuevo parámetro al final de una lista expandida, el cambio solo afectará a una línea, evitando que todo el bloque de código sea marcado como “modificado” por el control de versiones.

Finalmente, ten en cuenta las reglas estéticas fijas: el uso de comillas simples, una indentación de 2 espacios y el límite de 80 caracteres por línea. Si tu código excede este límite, el formateador aplicará saltos de línea automáticos para mantener la legibilidad.

N° 98