اصول کدنویسی استاندارد (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برای شناسایی هشدارهای ایستا پیش از انتشار استفاده کنید.