学习最佳实践，用 Flutter 提高代码质量、可读性、可维护性和生产率。
1. 将代码重构为 widgets 而不是 methods
重构成一个方法可能看起来很诱人，但是当构建方法太大时，它可能会重新构建，即使构建方法内部没有任何更改。但是，当涉及到重构到一个 widgets 时，我们得到了 widgets 生命周期的所有好处，因此只有当 widgets 中的某些内容发生变化时，它才会重新构建。因此，这可以防止不必要的重新构建，从而提高性能。这也提供了 Flutter 为 widgets 类提供的所有优化。
Column(
children: [
Container(
decoration: const BoxDecoration(
color: Colors.red,
),
child: const Text(
'Refactor to Widget',
style: TextStyle(
color: Colors.white,
),
),
),
],
)
//Do
class RefactorWidget extends StatelessWidget {
const RefactorWidget({
Key? key,
}) : super(key: key);
@override
Widget build(BuildContext context) {
return Container(
decoration: const BoxDecoration(
color: Colors.red,
),
child: const Text(
'Refactor to Widget',
style: TextStyle(
color: Colors.white,
),
),
);
}
}
//Do not
Container buildRefactorWidget() => Container(
decoration: const BoxDecoration(
color: Colors.red,
),
child: const Text(
'Refactor to Widget',
style: TextStyle(
color: Colors.white,
),
),
);
2. 尽可能使用 const 关键字
当我们使用 setState() Flutter 调用 build 方法并重新构建其中的每个 widgets 树。避免这种情况的最佳方法是使用常量构造函数。
在构建自己的 widgets 或使用 Flutter widgets 时，尽可能使用 const 构造函数。这有助于 Flutter 只重新构建应该更新的 widgets。
3. 使用级联运算符
如果我们应该对同一个对象执行一系列操作，那么我们应该选择级联 .. 接线员。
//Do
var path = Path()
..lineTo(0, size.height)
..lineTo(size.width, size.height)
..lineTo(size.width, 0)
..close();
//Do not
var path = Path();
path.lineTo(0, size.height);
path.lineTo(size.width, size.height);
path.lineTo(size.width, 0);
path.close();
4. 使用 spread collections
当现有项目已经存储在另一个集合中时，可以使用扩展集合，因为扩展集合语法使代码更简单、更容易。
//Do
var y = [4,5,6];
var x = [1,2,...y];
//Do not
var y = [4,5,6];
var x = [1,2];
x.addAll(y);
5. 使用 Null safe (??) 和 Null aware (?.) 操作符
在条件表达式中始终使用 ?? (如果为空)和 ?. (为空)运算符而不是空检查。
//Do
z = x ?? y;
//Do not
z = x == null ? y : x;
6. 避免使用 “as” 操作符代替 “is” 操作符
通常，如果无法进行强制转换，则 as 强制转换操作符将引发异常。若要防止引发异常，可以使用。
//Do
if (item is User)
item.name = 'Amir';
//Do not
(item as User).name = 'Amir';
7. 不要显式初始化变量 null
在 Dart 中，当没有指定变量的值时，该变量直观地初始化为 null，因此添加 null 是多余的，不需要。
//Do
int counter;
//Do not
int counter = null;
8. 在 Flutter 使用 SizedBox 代替 Container
Container 是一个非常棒的 widgets，您将在 Flutter 广泛使用它。 Container() 扩展到适合父节点给出的约束，并且不是常量构造函数。相反，SizedBox 是一个常量构造函数，构建一个固定大小的盒子。宽度和高度参数可以为 null，以指定不应在相应的维度中约束盒子的大小。因此，当我们必须实现占位符时，应该使用 SizedBox，而不是使用 Container。
// Do
return _isNotLoaded ? SizedBox.shrink() : YourWidget();
//Do not
return _isNotLoaded ? Container() : YourWidget();
9. 使用 raw 字符串
可以使用原始字符串来避免只转义反斜杠和美元。
//Do
var s = r'This is example of raw string \ and $';
//Do not
var s = 'This is example of raw string \\ and \$';
复制代码
10. 变量命名原则
Dart 有三种变数命名原则。
- UpperCamelCase 大骆驼峰
- lowerCamelCase 小骆驼峰
- lowercase_with_underscores 下划线连词
UpperCamelCase 大骆驼峰
// 类名
Classes ( eg:- MyClass )
class MyClass { … }
// 枚举
enum ( eg:- Status )
enum Status { none, running, stopped, paused }
// 类型定义
typedefs ( eg:- Signature )
typedef Signature<T> = bool Function(T value);
// 泛型名
type parameters ( eg:- T )
class Foo<T extends Object> { … }
// 扩展
extension ( eg:- MyMethod )
extension MyMethod<T> on List<T> { … }
lowercase_with_underscores 下划线连词
//packages 包
eg:- hive_flutter, url_launcher, flutter_svg
//directories (mostly lowercase only) 目录
eg:- lib, bin, src, test, example
//source files 文件
eg:- main.dart, home.dart
//import prefixes 导包
eg:- import 'dart:math' as math;
eg:- import 'dart:math' as my_math;
lowerCamelCase 小骆驼峰
// 内部类 变量
// Class members (instance/static methods and variables)
eg:- void myFun() {}, int studentRank = 1;
// top-level definitions
eg:- double topVariable;
// variables
eg:- int myValue = 3;
// parameters (both positional and named)
eg:- void fun({int myParam}){…} , void fun(int myParam) {…}
11. 使用 if 代替三元运算符语法, 在如下情况
当设计一个 Flutter 应用程序时，通常情况下需要有条件地呈现不同的 widgets。您可能需要基于该平台生成一个 widgets，例如:
Row(
children: [
Text("Amir"),
Platform.isAndroid ? Text("This is From Android") : SizeBox(),
Platform.isIOS ? Text("This is From IOS") : SizeBox(),
]
);
在这种情况下，您可以删除三元运算符，并利用 Dart 的内置语法在数组中添加 if 语句。
Row(
children: [
Text("Amir"),
if (Platform.isAndroid) Text("This is From Android"),
if (Platform.isIOS) Text("This if From IOS"),
]
);
