学习最佳实践,用 Flutter 提高代码质量、可读性、可维护性和生产率。
重构成一个方法可能看起来很诱人,但是当构建方法太大时,它可能会重新构建,即使构建方法内部没有任何更改。但是,当涉及到重构到一个 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,
),
),
);
当我们使用 setState()
Flutter 调用 build 方法并重新构建其中的每个 widgets 树。避免这种情况的最佳方法是使用常量构造函数。
在构建自己的 widgets 或使用 Flutter widgets 时,尽可能使用 const 构造函数。这有助于 Flutter 只重新构建应该更新的 widgets。
如果我们应该对同一个对象执行一系列操作,那么我们应该选择级联 ..
接线员。
//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();
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);
在条件表达式中始终使用 ??
(如果为空)和 ?.
(为空)运算符而不是空检查。
//Do
z = x ?? y;
//Do not
z = x == null ? y : x;
通常,如果无法进行强制转换,则 as 强制转换操作符将引发异常。若要防止引发异常,可以使用。
//Do
if (item is User)
item.name = 'Amir';
//Do not
(item as User).name = 'Amir';
在 Dart 中,当没有指定变量的值时,该变量直观地初始化为 null
,因此添加 null 是多余的,不需要。
//Do
int counter;
//Do not
int counter = null;
Container 是一个非常棒的 widgets,您将在 Flutter 广泛使用它。 Container()
扩展到适合父节点给出的约束,并且不是常量构造函数。相反,SizedBox
是一个常量构造函数,构建一个固定大小的盒子。宽度和高度参数可以为 null
,以指定不应在相应的维度中约束盒子的大小。因此,当我们必须实现占位符时,应该使用 SizedBox
,而不是使用 Container
。
// Do
return _isNotLoaded ? SizedBox.shrink() : YourWidget();
//Do not
return _isNotLoaded ? Container() : YourWidget();
可以使用原始字符串来避免只转义反斜杠和美元。
//Do
var s = r'This is example of raw string \ and $';
//Do not
var s = 'This is example of raw string \\ and \$';
复制代码
Dart 有三种变数命名原则。
UpperCamelCase 大骆驼峰
// 类名
Classes ( eg:- MyClass )
class MyClass { … }
// 枚举
enum ( eg:- Status )
enum Status { none, running, stopped, paused }
// 类型定义
typedefs ( eg:- Signature )
typedef Signature = bool Function(T value);
// 泛型名
type parameters ( eg:- T )
class Foo { … }
// 扩展
extension ( eg:- MyMethod )
extension MyMethod on List { … }
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) {…}
当设计一个 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"),
]
);