dart-best-practices

Je remarque que vous avez fourni "|-" ce qui semble être un début incomplet de tableau Markdown. Pouvez-vous s'il vous plaît fournir le texte complet à traduire ? Je suis prêt à : 1. Traduire le contenu en français 2. Préserver strictement le formatage Markdown 3. Conserver les noms propres, marques et commandes techniques en anglais 4. Retourner uniquement la traduction Veuillez partager le texte que vous souhaitez faire traduire.

npx skills add https://github.com/flutter/skills --skill dart-best-practices

Les meilleures pratiques Dart

1. Quand utiliser cette compétence

Utilisez cette compétence lorsque :

  • Vous écrivez ou examinez du code Dart.
  • Vous cherchez des conseils sur l'utilisation idiomatic de Dart.

2. Les meilleures pratiques

Chaînes multi-lignes

Préférez utiliser des chaînes multi-lignes (''') plutôt que de concaténer des chaînes avec + et \n, surtout pour les grands blocs de texte comme les requêtes SQL, le HTML ou les clés codées en PEM. Cela améliore la lisibilité et évite les erreurs de lint lines_longer_than_80_chars en permettant des sauts de ligne naturels.

À éviter :

final pem = '-----BEGIN RSA PRIVATE KEY-----\n' +
    base64Encode(fullBytes) +
    '\n-----END RSA PRIVATE KEY-----';

À préférer :

final pem = '''
-----BEGIN RSA PRIVATE KEY-----
${base64Encode(fullBytes)}
-----END RSA PRIVATE KEY-----''';

Longueur de ligne

Évitez les lignes de plus de 80 caractères, même dans les fichiers Markdown et les commentaires. Cela garantit que le code est lisible dans les affichages en écran partagé et sur les petits écrans sans avoir besoin de faire défiler horizontalement.

À préférer : Visez 80 caractères pour l'enveloppe du texte. Des exceptions sont autorisées pour les longs URL ou les identifiants qui ne peuvent pas être divisés.

Découverte

Chaînes multi-lignes

Pour trouver des candidats pour les chaînes multi-lignes, recherchez la concaténation de chaînes avec + impliquant des sauts de ligne :

  • Regex : ['"]\s*\+\s*['"]
  • Regex : \+\s*['"].*\\n

Longueur de ligne

  • Fiez-vous au lint lines_longer_than_80_chars de l'analyseur.

Compétences connexes

  • dart-modern-features : Pour l'utilisation idiomatic des fonctionnalités modernes de Dart comme le Pattern Matching (utile pour l'extraction JSON profonde), les Records et les Switch Expressions.