En este módulo, aprenderemos sobre las mejores prácticas para mantener un código limpio, legible y mantenible en Dart. Seguir un estilo de código consistente no solo facilita la colaboración en equipo, sino que también ayuda a evitar errores y a mejorar la eficiencia del desarrollo.

Un estilo de código consistente:

• Mejora la legibilidad: Facilita la comprensión del código por parte de otros desarrolladores.
• Facilita el mantenimiento: Hace que el código sea más fácil de actualizar y depurar.
• Promueve buenas prácticas: Ayuda a evitar errores comunes y a seguir patrones de diseño recomendados.

Dart tiene una guía de estilo oficial que se puede encontrar en Effective Dart. A continuación, se presentan algunos de los puntos más importantes.

• Clases y Enum: Usar UpperCamelCase.

  class MyClass {}
  enum Color { red, green, blue }
  

• Variables, funciones y parámetros: Usar lowerCamelCase.

  var myVariable;
  void myFunction() {}
  

• Constantes: Usar lowerCamelCase o UPPER_SNAKE_CASE.

  const pi = 3.14;
  const MAX_SIZE = 100;
  

• Usar 2 espacios para la sangría.

  void main() {
    if (true) {
      print('Hello, Dart!');
    }
  }
  

• No usar tabulaciones.

• Mantener las líneas de código por debajo de 80 caracteres.

  // Correcto
  var myString = 'This is a string that is less than 80 characters long.';
  
  // Incorrecto
  var myString = 'This is a string that is way too long and exceeds the 80 characters limit, which is not recommended.';
  

• Siempre usar llaves {} para bloques de código, incluso si contienen una sola línea.

  // Correcto
  if (condition) {
    doSomething();
  }
  
  // Incorrecto
  if (condition)
    doSomething();
  

• Usar espacios en blanco para mejorar la legibilidad.

  // Correcto
  var sum = a + b;
  
  // Incorrecto
  var sum=a+b;
  

• Usar comentarios para explicar el "por qué" del código, no el "qué".

  // Correcto
  // Calculate the area of a circle.
  double area = pi * radius * radius;
  
  // Incorrecto
  // Multiply pi by radius squared.
  double area = pi * radius * radius;
  

Dart proporciona una herramienta de formateo automática llamada dartfmt. Esta herramienta puede formatear tu código según las convenciones de estilo de Dart.

• Instalación y uso:

  dart format .
  

El analizador de Dart (dart analyze) puede ayudarte a encontrar problemas en tu código y a asegurarte de que sigues las mejores prácticas.

• Instalación y uso:

  dart analyze
  

Dado el siguiente fragmento de código, formatearlo según las convenciones de estilo de Dart.

En esta sección, hemos aprendido la importancia de seguir un estilo de código consistente y las principales convenciones de estilo en Dart. También hemos visto cómo usar herramientas como dartfmt y dart analyze para mantener nuestro código limpio y libre de errores. Siguiendo estas prácticas, podemos escribir código más legible, mantenible y profesional.