Dart ベストプラクティス

1. このスキルを使うとき

以下の場合にこのスキルを使用してください:

• Dartコードを書いている、またはレビューしている。
• 慣用的なDart使用法についてのガイダンスを探している。

2. ベストプラクティス

複数行文字列

特に SQL クエリ、HTML、PEM エンコード鍵などの大きなテキストブロックの場合、+ と \n で文字列を連結する方法より、複数行文字列 (''') の使用を優先してください。これは可読性を向上させ、自然な改行を許可することで lines_longer_than_80_chars リント エラーを回避します。

避けるべき:

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

推奨:

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

行の長さ

Markdown ファイルとコメントでも、80 文字を超える行は避けてください。これにより、分割画面ビューやより小さい画面でコードが読みやすくなり、水平スクロールが不要になります。

推奨: テキストをラップするために 80 文字を目標にしてください。長い URL または分割できない識別子は例外として許可されます。

検出

複数行文字列

複数行文字列の候補を見つけるには、改行を含む + での文字列連結を検索してください:

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

行の長さ

• アナライザーからの lines_longer_than_80_chars リントに依存してください。

関連スキル

• dart-modern-features: パターンマッチング (深い JSON 抽出に有用)、レコード、スイッチ式などの最新 Dart 機能の慣用的な使用法について。