اصول کدنویسی استاندارد (Effective Dart)

Effective Dart: Style & Best Practices

راهنمای رسمی نام‌گذاری کلاس‌ها، متغیرها، فایل‌ها و نگارش کد تمیز و خوانا مطابق استانداردهای تیم Dart

فهرست مطالب این صفحه

رعایت یک سبک کدنویسی یکپارچه در کل اکوسیستم Dart و Flutter باعث می‌شود کدهای شما برای سایر توسعه‌دهندگان به‌سادگی قابل خواندن و نگهداری باشند.

قوانین نام‌گذاری در Dart

در زبان Dart از سه قرارداد نام‌گذاری استاندارد استفاده می‌شود:

سبک نام‌گذاری مثال محل استفاده در Dart
UpperCamelCase SliderMenu، HttpRequest نام کلاس‌ها، enumها، typedefها و extensionها
lowerCamelCase userName، fetchData() نام متغیرها، پارامترها، توابع، متدها و ثابت‌ها (const)
lowercase_with_underscores home_screen.dart، flutter_docs نام فایل‌ها، پوشه‌ها و نام پکیج‌ها (Packages)
Dart
// مثال استاندارد نام‌گذاری در Dart
class UserProfileCard {
  const UserProfileCard({required this.displayName});

  final String displayName;
  static const int maxNameLength = 32;
}

استفاده صحیح از final و استنتاج نوع

  • در متغیرهای محلی داخل توابع، در صورتی که نوع متغیر از مقدار سمت راست کاملاً مشخص است، نیازی به تکرار نوع نیست (final items = <String>[];).
  • همیشه از ابزار dart format برای قالب‌بندی خودکار کدها و از dart analyze برای شناسایی هشدارهای ایستا پیش از انتشار استفاده کنید.