• frontend
  • flutter
  • Dart 基础语法

Dart 基础语法

一个简单的 Dart 程序

在 dart 中，我们需要在main函数中运行程序，所有代码都需要写到main里面才能调用。

dart
1// 定义一个函数.
2void printInteger(int aNumber) {
3  print('The number is $aNumber.'); // 打印到输出台
4}
5
6// 应用开始执行的位置，必须要写
7void main() {
8  var number = 42; // 声明并初始化一个值
9  printInteger(number); // 执行一个函数
10}

上面的代码中包含了以下内容：

// ：注释

viod：表示函数没有返回值

var：让 Dart 自动判断类型的声明方式

print()：打印内容

int：整型数字类型

$variableName或者${expression}：字符串插值，字符串变量中包含变量或表达式

main()：特殊且必须的顶级函数，Dart 会从这个函数开始执行

重要概念

  1. 所有变量引用的都是对象，每个对象都是一个类的实例。数字、函数以及 nulll 都是对象。除了 null 外（如果开启了空安全），所有类都继承于 Object 类。
  2. 尽管 Dart 是强类型语言，但是在声明变量时可以不指定类型，Dart 拥有跟 Typescript 一样的类型推断。
  3. 如果开启了空安全，变量在未声明为可空类型时不能为 null。可以通过类型后加文号(?)将类型声明为可为空。例如 int?声明的变量可以是整数数字也可以是 null。
  4. 如果 Dart 认为一个表达式可能为空，但是你明确知道它不可能为空时，可以用断言(!)来表示不为空。例如：int x=nullableButNotNullInt!
  5. 如果我们想要显式表示允许任意类型，可以使用 Object?(在开启空安全的情况下)、Object 或者特殊类型 dynamic
  6. Dart 支持泛型，比如数组的泛型 List<int>表示由 int 对象组成的列表或List<Object>表示由任意类型对象组成的列表
  7. Dart 支持顶级变量以及定义类或对象的变量（静态和实例变量）。实例变量可以称为属性。
  8. Dart 没有 public、protected 和 private 成员访问限定符。想要表示私有的，则用_当做标识符放在变量声明前面。
  9. 变量声明和其他语言一样，可以用字母或者下划线开头，后面放字符和数字的组合。
  10. Datr 的表达式有值，语句没有值。比如条件表达式expression condition ? expr1 : expr2中含有值expr1 expr2，if-else分支语句则没有值。
  11. Dart 工具会显示警告和错误两种类型的问题。警告表示代码有问题但是不会阻止运行；错误分编译错误和运行错误，编译错误代码不能运行，运行错误则会在运行时导致异常。

变量声明

变量声明可以用以下方式：

dart
1var str='hello dart';
2var num=123;
3// 字符串类型
4String str='hello dart';
5// 数字类型
6Int num=123;

使用 var 可以自动推断类型，也可以像 Java 一样手动写上类型String。

首选自动推断,来自 Dart 语言官方的高效指南建议

如果一个对象的引用可以是任意类型，就跟 TS 的 any 一样，那么可以指定 Object 或 dynamic 类型

dart
1  Object a = 'blob';
2  a = 123;
3  a = [];
4  dynamic b = 'blob';
5  b = 123;
6  b = [];

Object 和 dynamic 的区别

Object 是所有类的基类，相当于一个可以兼容所有类型的超级类型。dynamic 就是一个动态类，类似 TypeScript 的 any。

在下面代码中，如果用 Object 类声明会过不了编译。

dart
1  Object a = 'String';
2  a.subString(1); //❌The method 'subString' isn't defined for the type 'Object'

换成dynamic就表示这是动态类型，可以绕过编译检查。

dart
1  dynamic a = 'String';
2  a.substring(1);

final 和 const 的区别

常量可以用 final 和 const 修饰符来声明,这两个关键字可以替代 var 或者加在类型前面。

dart
1final name='some name';
2const age=20;
3const int age = 123;
4final List list = [];

final包含了const的功能，区别在于：

  • final 可以一开始不赋值，如果赋值了则只赋值一次。const 一开始就需要赋值
  • const 必须给一个明确的编译常量值（即编译期间就确定的值）
  • final 可以通过计算/函数获取一个值（即运行期间确定的值）
  • final 不仅有 const 编译时的常量的特性，而且是惰性初始化，即在运行时第一次使用前才初始化

举个例子

dart
1  // 报错了 const一开始就需要赋值  The constant 'a' must be initialized.
2	const a;
3  // 报错了 Const variables must be initialized with a constant value.
4  const a = new DateTime.now();
5
6  final b;
7  b = new DateTime.now(); // 不会报错

const 变量是编译时常量。如果使用 const 修饰类中的变量，则必须加上 static 关键字，即 static const。

const

在声明 const 变量时可以直接为其赋值，也可以使用其它的 const 变量为其赋值。

dart
1const bar = 1000000; // Unit of pressure (dynes/cm2)
2const double atm = 1.01325 * bar; // Standard atmosphere

const 关键字不仅仅用来定义常量，还可以用来创建常量值，该常量值可以赋予给任何变量。也可以将构造函数声明为 const，这种类型的构造函数创建的对象是不可改变的。

dart
1  var foo = const [];
2  final bar = const [];
3  const baz = []; // 相当于`const []`

使用初始化表达式为常量赋值就可以省略掉关键字 const，比如常量 bar 的赋值就省略掉了 const。

使用 const 变量还能够创建一个类似单例的对象，比如下面的语法，能够创建一个相同的对象

dart
1class Person {
2  final String name;
3  const Person(this.name);
4}
5
6void main(List<String> args) {
7  const p1 = const Person('myname');
8  const p2 = Person('myname'); // const 可以省略
9  print(identical(p1, p2));// 这两个对象是相等的
10}

默认值

未初始化并且可空类型的变量的默认值是 null。

dart
1int? lineCount;
2assert(lineCount == null);
3var a;
4assert(a == null);

assert() 的调用将会在生产环境的代码中被忽略掉。在开发过程中，assert(condition) 将会在 条件判断 为 false 时抛出一个异常。

如果启用了空安全，那么一个变量必须在你用它之前初始化

dart
1  int count;
2  // The non-nullable local variable 'count' must be assigned before it can be used.不为空的局部变量必须先赋值后使用
3  print(count);

我们不必在一开始声明时就初始化变量，但是需要在用之前赋值。举个例子，下面的代码是有效的，因为 dart 检测到 count 被传递给 print 函数使用之前是一个已经被赋值的变量

dart
1  int count;
2  count = 0;
3  print(count);

顶级和类变量被懒惰地初始化：初始化代码在首次使用变量时运行。

数据类型

  • Numbers 类型：int 整型和 double 浮点类型

  • Strings 类型：String

  • Booleans 类型：bool

  • Lists 类型：List

  • Maps 类型：Map 类型

  • Sets 类型：Set

  • Symbols 类型：Symbol

  • Null：null

  • Runes：常用于在 Characters API 中进行字符替换

Dart 中每个变量引用都指向对象，通常也可以使用构造器来初始化变量。一些内置的类型有自己的构造器，比如使用Map()创建一个map对象。

在 Dart 中有一些特殊作用的类型：

  1. Object：是除了 Null 类型以外所有类型的超类
  2. Future 和 Stream：用于异步
  3. Iterable：用于 for-in 循环和同步的 generator 构造器
  4. Never：象征表达式永远无法被到达。多用于函数抛出例外。
  5. dynamic：如果需要禁止静态检查，可以使用这个类型。平常可以用 Object 或者 Object?代替。
  6. void：多用于表示没有返回值

Numbers

int 为整型，double 为浮点数类型。

数字类型是 num 的子类。num 定义了一些基本的运算符和方法。还可以查看 dart:math 库中的 API。

double 类型可以兼容整型，即 double 既可以是整型也可以是浮点数型。

如果想要声明一个类型是数字类型，既可以是整型也可以是浮点数，则可以用num类型

dart
1  num x = 1;
2  x += 2.5;
3  print(x); // 3.5

如果声明一个 double 类型，但是值是整型的话，会自动转换成浮点数。

dart
1  double a = 1;
2  print(a); // 1.0

数字转字符串：toString()

dart
1  int a = 123;
2  double b = 123.23;
3  String _a = a.toString();
4  assert(_a == '123');
5  String _b = b.toStringAsFixed(1);
6  assert(_a == '123.2');

字符串转数字：parse

dart
1  String a = '123';
2  String b = '123.23';
3  int _a = int.parse(a);
4  assert(_a == 123);
5  double _b = double.parse(b);
6  assert(_b == 123.23);

建议都用 double.parse 转换成数字

Strings

字符串可以用单/双引号，在双引号中使用单引号可以不用转义，反过来也是一样。

dart
1var s1 = '使用单引号创建字符串字面量。';
2var s2 = "双引号也可以用于创建字符串字面量。";
3var s3 = '使用单引号创建字符串时可以使用斜杠来转义那些与单引号冲突的字符串：\'。';
4var s4 = "而在双引号中则不需要使用转义与单引号冲突的字符串：'";

字符串拼接用$或者${}或+,具体用法是${表达式}，如果是单变量，则可以省略{}.如果表达式的结果是一个对象，那么 Dart 会自动调用该对象的 toString 方法获取一个字符串。

dart
1  var s = 'this is string';
2  var map = {"name": "qiuyanxi"};
3  print('s 的值是：${s.toUpperCase()} map的值是$map');
4  // s 的值是：THIS IS STRING map的值是{name: qiuyanxi}

使用三个单引号或者三个双引号能创建多行字符串。

dart
1var s1 = '''
2You can create
3multi-line strings like this one.
4''';
5
6var s2 = """This is also a
7multi-line string.""";

如果希望字符串中的内容不会被做任何处理（比如转义），则可以在字符串前面加上 r 来创建 raw 字符串。

dart
1var s = r'在 raw 字符串中，转义字符串 \n 会直接输出 “\n” 而不是转义为换行。';

如果字符串是 const 声明的编译时常量，编译时常量 (null、数字、字符串、布尔) 才可以作为该字符串字面量的插值表达式。

dart
1// 这些在 const 声明的字符串常量中能用
2const aConstNum = 0;
3const aConstBool = true;
4const aConstString = 'a constant string';
5
6// 这些在 const 字符串中不能用，用 var 声明的才有用
7var aNum = 0;
8var aBool = true;
9var aString = 'a string';
10const aConstList = [1, 2, 3];
11
12const validConstString = '$aConstNum $aConstBool $aConstString';
13// const invalidConstString = '$aNum $aBool $aString $aConstList';
14var invalidConstString = '$aNum $aBool $aString $aConstList';

booleans

bool 表示布尔类型

Dart 的条件判断跟 JavaScript 不太一样，JavaScript 可以用 falsy 值或 truthy 值做条件判断

javascript
10、‘’、false、undefined、null、-0、NaN // javascript 的 falsy 值
2
3// 比如：
4let a;
5if (!a) {
6  console.log(`a为${a}`); // a为undefined
7}

dart 需要用 bool 型或者返回 bool 型的值才可以做条件判断。

bool 型

dart
1  String? a = null;
2  // Conditions must have a static type of 'bool'.Try changing the condition
3  // ❌  条件必须是bool 类型
4/*   if (a) {
5    print(a);
6  } else {
7    print(a);
8  } */
9  /* 下面代码才是正确的 */
10  bool b;
11  bool getResult() {
12    return true;
13  }
14
15  b = getResult();
16  if (b) {
17    print(b);
18  } else {
19    print(b);
20  }

返回 bool 型的值

dart
1// dart 版本 判断是否是空字符串、是否是 NaN、是否是 null、是否是0
2// Check for an empty string.
3var fullName = '';
4assert(fullName.isEmpty);
5
6// Check for zero.
7var hitPoints = 0;
8assert(hitPoints == 0);
9
10// Check for null.
11var unicorn;
12assert(unicorn == null);
13
14// Check for NaN.
15var iMeantToDoThis = 0 / 0;
16assert(iMeantToDoThis.isNaN);

Lists

跟 JavaScript 中的数组差不多，Dart 的数组也是封装后的 Object 特殊类，并不是传统意义上的数组。

list的声明方式

dart
1  var arr = <String>['0', '1', '2', '3']; // 定义数组类型
2  var arr1 = [0, 1, 2, 3, 4]; //自动推断
3	List arr5 = <String>['0', '1', '2', '3'];// 使用类型的方式定义list

  • 使用 const 关键字创建编译时变量，不能修改、增加

    dart
    1  var arr2 = const [1, 2, 3, 4]; // 创建一个编译时的常量，不能修改、增加
2  arr2.add(5); // Cannot add to an unmodifiable list

  • 创建一个固定长度的集合

    dart
    1	var arr3 = List.filled(2,'');// 创建一个固定长度的集合
2	var arr4 = List.filled<int>(2,0);// 创建一个固定长度的有类型的集合

  • 扩展操作符对数组的操作

    dart
    1  var list = [1, 2, 3];
2  var list2 = [0, ...list]; // 将 list 插入 list2 中
3  assert(list2.length == 4);

  • 空感知操作符对数组的操作,如果是 null 则可以避免异常

    dart
    1var list;
2var list2 = [0, ...?list];
3assert(list2.length == 1);

  • 获取数组长度

    dart
    1  var arr = <String>['0', '1', '2', '3'];
2	arr.length

  • 判断是否为空

    dart
    1  var arr = <String>['0', '1', '2', '3'];
2  arr.isEmpty
3  arr.isNotEmpty

  • 翻转数组

    dart
    1  var arr = ['1', '2'];
2  var newArr = arr.reversed.toList();
3  print(newArr);

  • 在 List 中可以使用 if 或 for

    dart
    1  var nav = ['Home', 'Furniture', 'Plants', if (true) 'Outlet'];
2  var listOfInts = [1, 2, 3];
3  var listOfStrings = ['#0', for (var i in listOfInts) '#$i'];
4  print(listOfStrings); // [#0, #1, #2, #3]

其他 API 就不废话了，参考官方文档即可。

Sets

dart 的 set 声明

dart
1  var halogens = {'fluorine', 'chlorine', 'bromine', 'iodine', 'astatine'};
2  Set s = <String>{'fluorine', 'chlorine'};

在{}前加上类型参数可以创建一个空的 Set，或者将{}赋值给一个 Set 类型的变量

dart
1  var s = <String>{};
2  Set _s = <String>{};
3  Set<String> names = {};
4  var _names = {}; // 这是一个 map 不是 set
  • 使用add方法或者addAll方法可以添加项目
dart
1  var sets = <Object>{};
2  sets.add('1');
3  sets.addAll([1, 2, 3]);
4  print(sets);

  • 使用.length可以获取 Set 中元素的数量

    dart
    1  final sets = {'fluorine', 'chlorine'};
2  print(sets.length);

  • Set 变量前添加const关键字创建 Set 编译时变量

    dart
    1final constantSet = const {
2  'fluorine',
3  'chlorine',
4  'bromine',
5  'iodine',
6  'astatine',
7};
8// constantSet.add('helium'); // This line will cause an error.

  • Set 可以使用扩展操作符和空感知操作符

    dart
    1  final sets = {'fluorine', 'chlorine'};
2  var maybeNull;
3  final a = <String>{'hello', ...sets};
4  final b = <String>{'hello', ...?maybeNull};
5  print(a);
6  print(b);

Maps 类型

Dart 中的 Maps 类型类似 JavaScript 中的 Map 数据结构，区别是需要强制在 key 上加引号。Maps 类型在 Dart 中当 object 用。

声明 map，使用 var 能让 Map 自动推断，也可以手动写 Map 的类型

dart
1  const a = [1, 2, 3];
2  var map = {a: '123'}; // map 当 js 的map 用，key 不用写成[key]
3  var map1 = <String,String>{'a': '123'}; // map 当js 的 object用，key需要加引号
4  var map2 = Map(); // 创建自由类型的 map,可以加 new
5  var map3 = Map<int, String>(); // 创建 map 时定义类型
6  map3[1] = '1'; // 给 map 赋值
7  print(map);
8  print(map1);
9  print(map.containsKey(a)); // js的 map.has 方法判断是否有这个 key

JavaScript 中可以用new Map()让普通函数变成构造函数，dart 中则可以省略掉 new，上面的代码使用Map()构造函数就可以创建一个 map 对象。

  • 添加单个属性和多个属性

    dart
    1  var map = {};
2  map['age'] = 20;
3  map.addAll({"name": 'qiuyanxi', 1: 2});
4  print(map);

  • 如果 key 不在 map 中会返回 null

    dart
    1  var map = {};
2  assert(map['name'] == null);

  • 获取.length 可以获取键值对的数量

    dart
    1  var map = {};
2  assert(map.length == 0);

  • 在一个 Map 字面量前添加 const 关键字可以创建一个 Map 编译时常量：

    dart
    1final constantMap = const {
2  2: 'helium',
3  10: 'neon',
4  18: 'argon',
5};
6
7// constantMap[2] = 'Helium'; // This line will cause an error.

  • Map 使用扩展运算符和空感知操作符

    dart
    1  var map = {'name': "qiuyanxi"};
2  Map? maybeNull;
3  var newMap = {...map};
4  var newMap2 = {...?maybeNull};

获取类型

使用runtimeType可以获得对象的类型

dart
1  var n = null;
2  var s = 'String';
3  print(n.runtimeType); // Null
4  print(s.runtimeType); // String

函数

定义函数，建议定义返回类型

dart
1  String getName() {
2    return 'qiuyanxi';
3  }

只有一个表达式的函数能够使用箭头函数简化

dart
1  String getName() => 'qiuyanxi';

必要参数

dart
1  String getName(String name, int age) => '$name$age';
2  getName('qiuyanxi', 10);

可选的位置参数

使用[]表示可选的位置参数

dart
1  void printThings([String? str, String str2 = 'default value']) {
2    assert(str == null);
3    assert(str2 == 'default value');
4  }
5  printThings();

命名参数

命名参数默认都为可选参数。如果是必要参数，则需要用required

定义函数时，使用{参数 1，参数 2}来指定命名参数

dart
1  String getName2({required String name, int? age = 10}) => '$name$age';

调用函数时，使用 参数名:参数值指定命名参数

dart
1  getName2(name: 'qiuyanxi');

默认参数

如果一个参数是可选的但是不能是 null，那么需要提供一个默认的值。没有默认值的情况下参数是 null

dart
1/// Sets the [bold] and [hidden] flags ...
2void enableFlags({bool bold = false, bool hidden = false}) {...}
3
4// bold will be true; hidden will be false.
5enableFlags(bold: true);

默认值

只有可选参数才有默认值，默认值必须为 编译时常量，如以下的参数为默认的 List 和 Map，为了变成编译时常量，需要加上 const 关键字

dart
1  void getList([List<int> list = const [1, 2, 3]]) {}
2  void getMap([Map<String, String> map = const {"name": "qiuyanxi"}]) {}

main 函数

main 函数是每个 Dart 程序必须有的顶级函数，是程序的入口，main 函数返回值是 void ，并且有一个List<String>类型的可选参数。

可以通过命令行给 main 函数传递参数

hello-world.dart

dart
1void main(List<String> args) {
2  // 在命令行运行以下命令: dart hello-world.dart 1 test
3  print(args); //['1', 'test']
4  assert(args.length == 2);
5  assert(int.parse(args[0]) == 1);
6  assert(args[1] == 'test');
7}

匿名函数

匿名函数被当做参数使用

dart
1const list = ['apples', 'bananas', 'oranges'];
2list.forEach((item) {
3  print('${list.indexOf(item)}: $item');
4});

使用匿名箭头函数当做参数使用

dart
1const list = ['apples', 'bananas', 'oranges'];
2list.forEach((item) => print('${list.indexOf(item)}: $item'));

词法作用域

Dart 的作用域是词法作用域，跟 JavaScript 一样，在写代码的时候就确定了。

闭包

闭包也跟 JavaScript 一样，就不多介绍了。

返回值

所有函数都有返回值的，即使返回值是 void。如果没有明确写返回语句，那么默认执行return null

dart
1// 这是明确表示返回 void 的函数
2  void returnVoid() {
3    print('hello');
4  }
5
6  var a = returnVoid();
7  // void 类型的变量不能被使用
8  // print(a);
9
10// 这是没有返回语句的函数
11  returnNull() {}
12  var b = returnNull();
13  assert(returnNull() == null); // true

运算符

赋值运算符

dart
1  var a = 1;
2  int? b;
3  b ??= 2; // 如果 b 为空的话就把 2 赋值给 b
4  a += 0; // a=a+0

算数运算符

dart
1  print(a + b);
2  print(a - b);
3  print(a * b);
4  print(a / b);
5  print(a % b); // 取余
6  print(a ~/ b); // 取整
7	a ++ // 先运算再自增
8  a -- //先运算再自减
9  -- a // 先自减再运算
10  ++ a // 先自增再运算

关系运算符

dart
1  print(a == b);
2  print(a >= b);
3  print(a <= b);
4  print(a != b);
5	identical(DateTime.now(), DateTime.now()); // 判断两个对象是否相等

类型判断运算符

OperatorMeaning
as类型转换（也用作指定 类前缀)）
is如果对象是指定类型则返回 true
is!如果对象是指定类型则返回 false

逻辑运算符

| 运算符 | 描述 | | ----------- | --------------------------------------------------------- | --- | ------ | | !*表达式* | 对表达式结果取反（即将 true 变为 false，false 变为 true） | | | | | 逻辑或 | | && | 逻辑与 |

dart
1  var c = false;
2  var d = true;
3  /* 取反 */
4  if (!c) {
5    print(c);
6  }
7  /* && 并且 */
8  if (c && d) {}
9  /* || 或 */
10  if (c || d) {}

表达式

表达式 1 ?? 表达式 2

如果表达式 1 为 null 则返回表达式 2

dart
1  /* ??运算符 */
2  var i;
3  var j = i ?? 10; // i 为空则将 10 赋值给 j，同 js 空值合并运算符
4  print(j);

条件 ? 表达式 1 : 表达式 2

dart
1  /* 三目运算符 */
2  var flag;
3  flag = true;
4  var f = flag ? 'true' : 'false';

级联运算符

级联运算符 (.., ?..) 可以让你在同一个对象上连续调用多个对象的变量或方法。

下面代码

dart
1var paint = Paint()
2  ..color = Colors.black
3  ..strokeCap = StrokeCap.round
4  ..strokeWidth = 5.0;
5
6/* 相当于  */
7var paint = Paint();
8paint.color = Colors.black;
9paint.strokeCap = StrokeCap.round;
10paint.strokeWidth = 5.0;
11
12querySelector('#confirm') // Get an object.
13  ?..text = 'Confirm' // Use its members.
14  ..classes.add('important')
15  ..onClick.listen((e) => window.alert('Confirmed!'));
16
17/* 相当于  */
18var button = querySelector('#confirm');
19button?.text = 'Confirm';
20button?.classes.add('important');
21button?.onClick.listen((e) => window.alert('Confirmed!'));

其他运算符

运算符名字描述
()使用方法代表调用一个方法
[]访问 List访问 List 中特定位置的元素
?[]判空访问 List左侧调用者不为空时，访问 List 中特定位置的元素
.访问成员成员访问符
?.条件访问成员与上述成员访问符类似，但是左边的操作对象不能为 null，例如 foo?.bar，如果 foo 为 null 则返回 null ，否则返回 bar

判空

  • 判断字符串是否为空

    dart
    1  var str = '';
2  if (str.isEmpty) {
3    print(' 判断为空字符串');
4  }

  • 判断是否为 null

    dart
    1  var _null = null;
2  if (_null == null) {
3    print('判断为 null');
4  }

  • 判断是否为 NaN

    dart
    1  var _nan = 0 / 0;
2  if (_nan.isNaN) {
3    print('是 NaN');
4  }

空安全

Dart 目前支持控安全机制，也就是说除非我们声明它可空，否则它们的值不能为空，这样做的好处是提高了代码的健壮性，在编译的时候就能报错。

空安全需要 dart 在 2.12 以上

声明可空的方式就是在类型前面加个问号：

dart
1  int? count;
2  count = null;

如果没有加问号，那么这个值就不能是空的

dart
1  int count;
2  // ❌ A value of type 'Null' can't be assigned to a variable of type 'int'.
3  count = null;

如果我们知道一个值不可能为空，但是 Dart 判断可能为空，那就用!表示非空断言

diff
1  String? getData(String? data) {
2    if (data is String) {
3      return 'this is string data';
4    }
5    return null;
6  }
7
8-  String a = getData('12131');
9+  String a = getData('12131')!;

流程控制语句

  • for 循环

    dart
    1  for (var i = 0; i < 10; i++) {
2    print(i);
3  }

    JavaScript 的 var 在 for 循环中只有一个作用域，dart 的 var 不存在这个问题，所以上面的代码能够正常打出 i的值。

  • for...in 循环

    使用 for..in 遍历可迭代对象，比如 Lists 类型和 Set 类型

    dart
    1  var list = [1, 2, 3];
2  var sets = <int>{1, 2, 3};
3  for (var value in list) {
4    print(value);
5  }
6  for (var value in sets) {
7    print(value);
8  }

    可迭代对象也可以使用forEach方法循环

    dart
    1var collection = [1, 2, 3];
2collection.forEach(print); // 1 2 3

  • while 循环

    dart
    1  var i = 10;
2  while (i > 0) {
3    print(i);
4    i--;
5  }

  • do while 循环

    dart
    1  do {
2    print(i);
3    i--;
4  } while (i > 0);

    do while 跟 while 的区别是即使不满足条件，do while 循环也会 do 一次；while 循环不会

    dart
    1  var i = 0;
2  do {
3    print(i); //这段代码执行了
4    i--;
5  } while (i > 0);
6
7  while (i > 0) {
8    print(i);// 永远不会执行
9    i--;
10  }

  • break，continue 语句

    break 跳出循环，continue 跳过本轮循环

  • switch 和 case

  • 断言——assert

    dart
    1  assert(1 < 2);
2  assert(1 > 2, '1>2 is wrong');

异常捕获

Dart 提供 Exception 和 Error 两种类型的异常以及一些子类。我们可以自己定义异常类型，也可以将任何非 null 对象作为异常抛出。

  • 抛出异常
dart
1  throw new Exception('这是一个异常报错');
2  throw '这是一个异常报错';

  • 捕获异常

    dart
    1  try {
2    // throw Error();
3    throw Exception('this is exception error');
4  } on Exception catch (e) {
5    print('this is Unknown exception $e');
6  } catch (e,s) {
7    print('No specified type, handles all error $e');
8    print('Stack trace:\n $s');
9  }

    上面的代码使用 on 和 catch 来捕获异常，on 来指定异常的类型，catch 则用来捕获对象。当抛出的错误并不是 on 指定的异常类型时，则走最后面的 catch 兜底。

    catch 方法有两个参数，第一个参数是抛出的异常对象，第二个参数是栈信息。

  • rethrow 再次抛出异常

    当我们在捕获到一个异常时，还可以再次将这个异常抛出。

    下面的例子将内层函数捕获的异常抛出到外部作用域让 main 函数里的代码捕获到。

    dart
    1void misbehave() {
2  try {
3    dynamic foo = true;
4    print(foo++); // Runtime error
5  } catch (e) {
6    print('misbehave() partially handled ${e.runtimeType}.');
7    rethrow; // Allow callers to see the exception.
8  }
9}
10
11void main() {
12  try {
13    misbehave();
14  } catch (e) {
15    print('main() finished handling ${e.runtimeType}.');
16  }
17}

    上面的代码会打印出如下信息：

    dart
    1misbehave() partially handled NoSuchMethodError.
2main() finished handling NoSuchMethodError.

  • Finally

    无论是否抛出异常，都会执行 finally 语句。

    dart
    1  try {
2    throw Error();
3  } catch (e) {
4    print('i will catch this error');
5  } finally {
6    print('finally print this message');
7  }

类

Dart 是支持基于 mixin 继承机制的语言（JavaScript 是基于原型的），所有对象都是一个类的实例，而除了 null 以外所有的类都继承自 Object 类。

定义类的属性和方法

dart
1// 类的定义不能写在 main 函数里
2class Person {
3  String? name; // Declare instance variable name, initially null.
4  int age = 0; // Declare y, initially 0.
5  void getInfo() {
6    print('${this.name} ------ ${this.age}');
7  }
8  void setName(String name) {
9    this.name=name;
10  }
11}
12void main(List<String> args) {
13  var p = new Person();// 可以省略 new
14  p.getInfo();
15  p.setName('my name');
16  p.getInfo();
17}

实例属性如果没有初始化的话，默认是 null。

所有实例变量都会隐式声明 Getter 方法。可以修改的实例变量和 late final 声明但是没有初始化的变量还会隐式声明一个 Setter 方法，我们可以通过 getter 和 setter 读取或设置实例对象。

dart
1class Person {
2  String? name;
3  int age = 0;
4  late final int height;
5}
6
7void main(List<String> args) {
8  var p = new Person();
9  p.name = 'my name';// setter
10  p.height = 180;// setter
11  print(p.name);// getter
12  print(p.height);// getter
13  p.height = 190; // Field 'height' has already been initialized.
14}

实例变量可以是 final 的，在这种情况下只能被 set 一次。

构造函数

用一个与类名一样的函数就可以创建构造函数，还有一种命名式构造函数。

dart
1class Point {
2  double x = 0;
3  double y = 0;
4  // Point(double x, double y) {
5  //   this.x = x;
6  //   this.y = y;
7  // }
8  // 上面构造函数的语法糖可以写成这样
9  Point(this.x, this.y);
10  // 命名式构造函数——使用初始化列表
11  Point.origin(double xOrigin, double yOrigin):x=xOrigin,y=yOrigin
12  // 命名式构造函数还可以这么写
13  // Point.origin(double this.x, double this.y);
14}
15// 在 main 中使用
16void main(List<String> args) {
17  // 使用命名构造函数
18  var p1 = new Point.origin(10, 20);
19  var p2 = Point(10, 20);
20}

使用 this 关键字引用当前实例。

如果没有声明构造函数，Dart 会自动生成一个没有参数的构造函数并且这个构造函数会调用其父类的无参数构造方法。

构造函数不会被继承，也就是说子类没办法继承父类的构造函数。命名式构造函数也不能被继承。

命名构造函数可以有多个，当实例化时根据需要直接调用就行了。

初始化列表

在构造函数运行之前，有一个初始化列表的概念。可以初始化实例变量

dart
1class Rect {
2  int height;
3  int width;
4  Rect()
5      : width = 10,
6        height = 10 {
7    print("${this.width}---${this.height}");
8  }
9  Rect.create(int width, int height)
10      : width = width,
11        height = height {
12    print("${this.width}---${this.height}");
13  }
14}
15
16void main(List<String> args) {
17  var p1 = Rect(); // 10---10
18
19  var p2 = Rect.create(100, 200); // 100---200
20}

当使用 Rect 构造时，初始化列表会给 width 和 height 初始化为 10。

当使用Rect.create构造时，初始化列表会通过用传入的值来初始化。

初始化列表可以解决一个类变量既是final的又是可选参数赋值的且可选参数默认值需要动态确定的问题。

dart
1class Person {
2  static final String name = 'myname';
3  final int age;
4  Person() : age = Person.name == 'myname' ? 10 : 20;
5}

上面的代码 age 是可选的且 age 的默认值需要动态确定，这时候就没办法使用可选参数了，如以下示例：

dart
1class Person {
2  static final String name = 'myname';
3  final int age;
4  // ❌ The default value of an optional parameter must be constant.
5  Person([this.age = Person.name == 'myname' ? 10 : 20]);
6}

重定向构造函数

当调用一个构造函数时，让这个构造函数能够调用另外一个构造函数，这就叫重定向构造函数。

下面的代码中，当调用Person.init()时，会重定向到Person这个构造函数中，本质上是初始化列表。

dart
1class Person {
2  String name;
3  int age;
4  Person(this.name, this.age);
5  Person.init(String name, int age) : this(name, age);
6}

常量构造函数

当类的变量是 final的，这时候就需要用const修饰构造函数，否则实例化时会报错。

下面例子中会创建两个相等的对象，类似于单例模式。

dart
1class Person {
2  final String name;
3  const Person(this.name);
4}
5
6void main(List<String> args) {
7  const p1 = const Person('myname');
8  const p2 = Person('myname'); // const 可以省略
9  print(identical(p1, p2));// 这两个对象是相等的
10}

工厂构造函数

普通构造函数会自动返回对象，工厂构造函数最大的特点是可以手动返回一个对象。

在工厂构造函数中无法访问 this

下面使用工厂构造函数能够主动返回一个单例

dart
1class Person {
2  String name;
3
4  static final Map<String, Person> cache = {};
5
6  Person(this.name);
7
8  factory Person.getSingle(String name) {
9    if (cache.containsKey(name)) {
10      return cache[name] as Person;
11    } else {
12      cache[name] = new Person(name);
13      return cache[name] as Person;
14    }
15  }
16}
17
18void main(List<String> args) {
19  var p1 = Person.getSingle('qyx');
20  var p2 = Person.getSingle('qyx');
21  print(identical(p1, p2));// true
22}

实例的私有属性/方法

将类抽离成一个文件，并在属性或者方法前加_就能定义实例对象的私有变量。

lib/Person.dart

dart
1class Person {
2  String? name; // Declare instance variable name, initially null.
3  int _age = 0; // Declare y, initially 0.
4  void getInfo() {
5    print('${this.name} ------ ${this._age}');
6  }
7}

main.dart

dart
1import 'lib/Person.dart';
2
3void main(List<String> args) {
4  var p = Person();
5  // print(p._age); 无效
6  p.getInfo();
7}

Getter 和 Setter

构造函数自动会设置实例变量的 getter 和 setter ，我们也可以手动指定，这种方式的好处是可以监听属性。

dart
1class Rect {
2  int height;
3  int width;
4  Rect(this.width, this.height);
5  // 手动指定 getter 的写法
6  get area {
7    return this.height * this.width;
8  }
9  // 手动指定 setter 的写法
10  set h(int value) {
11    print("当你调用 xx.h 时，会打印这段话，表示你已经被监听到了");
12    this.height = value;
13  }
14
15  set w(int value) {
16    this.width = value;
17  }
18}
19
20void main(List<String> args) {
21  var p = Rect(10, 20);
22  print(p.area);// getter
23  p.h = 100;// setter
24  p.w = 100;
25  print(p.area);
26}

静态成员

跟 TS 一样，使用 static 来声明静态成员。

dart
1class Rect {
2  static int height = 10;
3  static int width = 10;
4  static getArea() {
5    print(height * width);
6  }
7}
8
9void main(List<String> args) {
10  Rect.getArea();
11}

有两点需要注意:

  • 静态成员不能访问实例变量

    dart
    1class Rect {
2  int height = 10;
3  static int width = 10;
4  static getArea() {
5    print(this.height * width); // 报错了 不能访问 实例属性 height
6  }
7}

  • 实例方法可以访问静态成员

    dart
    1class Rect {
2  int height;
3  static int width = 10;
4  Rect(this.height);
5  getArea() {
6    print(this.height * width);// 如果访问实例属性，推荐加上 this。
7  }
8}
9
10void main(List<String> args) {
11  new Rect(10).getArea();
12}

继承

构造函数不能被继承，使用 extends 和 super 关键字来继承父类的属性和方法。

纯继承父类

dart
1class Animal {
2  String name;
3  void sound(voice) {
4    print(voice);
5  }
6
7  Animal(this.name);
8}
9
10class Dog extends Animal {
11  Dog([String name = 'dog']) : super(name);
12}
13
14void main(List<String> args) {
15  var dog = new Dog();
16  print(dog.name); // dog
17  dog.sound('汪汪'); // 汪汪
18}

其中Dog([String name = 'dog']) : super(name);需要解释一下：

  • : super(name)这种语法是用初始化列表在构造 Dog 时调用其父类的构造函数来设置 name
  • Dog([String name = 'dog'])这种语法是调用new Dog()时name 是可选的，默认值为dog

扩展子类的属性和方法

dart
1class Animal {
2  String name;
3  void sound(voice) {
4    print(voice);
5  }
6
7  Animal.create(this.name);
8}
9
10class Dog extends Animal {
11  String sex;
12  Dog(this.sex, [String name = 'dog']) : super.create(name);
13  void run() {
14    print('${this.name} runrun');
15  }
16}

重写父类的属性和方法

dart
1class Animal {
2  String name;
3  void sound(voice) {
4    print(voice);
5  }
6
7  Animal.create(this.name);
8}
9
10class Dog extends Animal {
11  String sex;
12  Dog(this.sex, [String name = 'dog']) : super.create(name);
13  void run() {
14    print('${this.name} runrun');
15  }
16
17  @override
18  void sound(voice) {
19    print('${this.name} $voice');
20  }
21}
22
23void main(List<String> args) {
24  var dog = new Dog('雄');
25  print(dog.name); // dog
26  dog.sound('汪汪'); //dog 汪汪
27}

推荐使用@override来重写父类的属性和方法

子类中调用父类的方法

通过 super来调用父类的方法

dart
1class Dog extends Animal {
2  String sex;
3  Dog(this.sex, [String name = 'dog']) : super.create(name);
4  void run() {
5    super.sound('汪汪');
6    print('${this.name} runrun');
7  }
8}

抽象类

  • 抽象类主要用于定义标准

  • 抽象类不能被实例化，只有继承它的子类才可以被实例化

  • 抽象类如果想被实例化，可以用工厂构造函数

使用abstract关键字表示这是抽象类。

比如下面定义一个 Animal 的抽象类，这里面有所有动物的标准。

dart
1abstract class Animal {
2  sound(); // 抽象方法
3  print() {} // 普通方法 可以不被子类实现
4}
5
6// 子类中必须实现同样的抽象方法
7class Dog extends Animal {
8  @override
9  sound() {}
10}

多态

多态就是同一操作作用于不同的对象时，可以产生不同的解释和不同的效果。

在 JavaScript 中是用原型链的方式来实现多态的，比如 Object 和 Array 的原型上都有 toString方法，本质上是在Array.prototype写了一个toString来覆盖Object.prototype的原型上的toString

Dart中的多态是通过子类重写父类定义的方法，这样每个子类都有不同的表现。

使用抽象类的话就只需要定义父类的方法而不用实现，让继承它的子类去实现，每个子类就是多态的。

dart
1abstract class Animal {
2  sound(); // 抽象方法
3}
4
5class Dog extends Animal {
6  @override
7  sound() {
8    print('汪汪');
9  }
10
11  run() {}
12}
13
14class Cat extends Animal {
15  @override
16  sound() {
17    print('喵喵');
18  }
19
20  run() {}
21}
22
23void main(List<String> args) {
24  var dog = new Dog();
25  var cat = new Cat();
26  print(dog.sound());
27  print(cat.run());
28  // 下面两个不能调 run 方法
29  Animal _dog = new Dog();
30  Animal _cat = new Cat();
31}

接口

dart 中没有 interface，我们使用抽象类来定义接口，使用implements来让类匹配接口。

类匹配单个接口

比如下面使用抽象类来封装统一的 增删改查 功能

dart
1abstract class Db {
2  String uri;
3  add();
4  remove();
5  save();
6  select();
7}

使用implements匹配接口

dart
1class MySql implements Db {
2  @override
3  add() {}
4
5  @override
6  remove() {}
7
8  @override
9  save() {}
10
11  @override
12  select() {}
13}

上面的代码也可以用 extends 关键字来继承后重写。一般情况下我们这么用：

  • 如果需要有共同的方法复用，我们用 extends

  • 如果需要一个规范约束，那就使用 implements

类匹配多个接口

dart
1abstract class A {
2  late String name;
3  getA();
4}
5
6abstract class B {
7  getB();
8}
9
10class C implements A, B {
11  @override
12  getA() {}
13
14  @override
15  getB() {}
16
17  @override
18  late String name;
19}

mixins 混入

使用 mixins 可以实现类似多继承的功能，mixins 用关键字 with 和 mixin

dart
1mixin A {
2  void getA() {}
3}
4
5mixin B {
6  void getB() {}
7}
8
9class C with A, B {}
10
11void main(List<String> args) {
12  var c = new C();
13  c.getA();
14  c.getB();
15}

上面的代码混入（mixins）了多个mixins类的实例方法。

  • 被 mixins 的类只能继承自 Object，不能继承其他类。

    dart
    1class A {
2  void getA() {}
3}
4
5class B extends A {
6  void getB() {}
7}
8
9class C with A, B {} // ❌报错，B 是被 mixins 的类，不能继承

    为了让 mixins 类更加直观，推荐使用 mixin 关键字来定义mixin 类

    mixin A {
  void getA() {}
}

mixin B extends A { // ❌报错，B 是被 mixins 的类，不能继承
  void getB() {}
}

class C with A, B {}

  • 被 mixins 的类不能有构造函数

    dart
    1mixin A {
2  void getA() {}
3}
4
5mixin B {
6  B(); // ❌报错 B 是被 mixins 的类，不能有构造函数
7  void getB() {}
8}
9
10class C with A, B {}

  • 一个类可以 mixins 多个 mixins 类

  • 一个类可以继承某个类再 mixins 一些 mixins 类

    dart
    1class A {
2  void getA() {}
3}
4
5class B {
6  void getB() {}
7}
8
9class C extends A with B {}

  • mixins 不是继承，也不是接口，当使用 mixins 后，相当于创建了一个超类，能够兼容下所有类

    dart
    1class A {
2  void getA() {}
3}
4
5mixin B {
6  void getB() {}
7}
8
9class C extends A with B {}
10
11void main(List<String> args) {
12  var c = new C();
13  print(c is A);// true
14  print(c is B);// true
15  print(c is C);// true
16}

  • 使用 on 关键字可以指定哪些类可以使用该 Mixin 类

    dart
    1class A {
2  void getA() {}
3}
4
5mixin B on A {
6  void getB() {}
7}
8
9// class C with B {}     ❌这样写是报错的
10class C extends A with B {}

泛型

跟 TS 一样，Dart 也支持泛型，泛型就是泛用的类型，是一种将指定权交给用户的不特定类型。

比如下面的函数就由用户指定传入的类型。

dart
1  T getData<T>(T data) {
2    return data;
3  }
4
5// 调用者可以指定类型
6  getData<String>('123');
7  getData<num>(123);
8	getData<List>([1, 2, 3]);

泛型类

在实例化一个类时可以通过泛型来指定实例对象的类型。

下面就是实例化 List 后指定了 List 对象属性值的类型。

dart
1  List l1 = new List<int>.filled(2, 1);
2  List l2 = new List<String>.filled(2, '');

  • 定义泛型类

    dart
    1class A<T> {
2  T age;
3  A(T this.age);
4  T getAge() {
5    return this.age;
6  }
7}
8

  • 使用泛型类

    dart
    1void main(List<String> args) {
2  // 使用泛型类
3  var a = new A<int>(12);
4  var b = A<String>('12');
5}

泛型接口

泛型接口的定义方式就是接口跟泛型类的集合体，可以这么定义

dart
1// 泛型接口
2abstract class Cache<T> {
3  void setKey(String key, T value);
4}
5// 类匹配这个接口
6class FileCache<T> implements Cache<T> {
7  @override
8  void setKey(String key, T value) {}
9}
10
11class MemoryCache<T> implements Cache<T> {
12  @override
13  void setKey(String key, T value) {}
14}

使用时指定泛型的具体类型

dart
1  var f = new FileCache<String>();// 指定 String
2  f.setKey('key', 'string');
3  var m = new MemoryCache<int>();// 指定 int
4  m.setKey('key', 123);

限制泛型

跟 Typescript 一样，泛型约束使用 extends 关键字。

dart
1abstract class Cache<T> {
2  void setKey(String key, T value);
3}
4// 这里约束MemoryCache只能为 int
5class MemoryCache<T extends int> implements Cache<T> {
6  @override
7  void setKey(String key, T value) {}
8}
9void main(List<String> args) {
10  // var m = new MemoryCache<String>(); 这里就不能是 String 类型了
11  var m = new MemoryCache<int>();
12  m.setKey('key', 123);
13}

enum

枚举的规则跟 Typescript 差别很大,最终目的还是用于定义常量值

  • 定义枚举

    dart
    1enum Colors { RED, GREEN, BLUE }

  • 访问枚举的下标

    dart
    1assert(Color.red.index == 0);

  • 获取全部枚举值

    dart
    1Colors.values // [Colors.RED, Colors.GREEN, Colors.BLUE]

  • 访问枚举值

    dart
    1Colors.RED // Colors.RED

  • 用下标访问枚举值

    dart
    1  assert(Colors.values[0] == Colors.RED);

  • 枚举值的类型

    dart
    1Colors.RED.runtimeType // Colors

Late 修饰符

Dart2.12 增加了 late 修饰符，它有两个用途：

  • 用来声明一个在声明后才初始化的且不能为 null 的变量
  • 懒初始化变量

Dart 的控制流分析可以检测不可为 null 的变量在使用之前何时设置为非 null 值，但有时分析会失败。两种常见情况是顶级变量和实例变量：Dart 通常无法确定它们是否已设置，因此它不会尝试。

如果你确定变量被使用之前已经被设置了，但是 Dart 判断不一致，就可以使用 late 来消除报错

dart
1// The non-nullable variable 'a' must be initialized.
2String a;
3void main(List<String> args) {
4  a = '123';
5  print(a);
6}

上面的代码中， a 是全局变量，Dart 没有办法分析全局变量是否被设置，因此上面的代码会报错。这时候可以用 late 语句来消除错误。

diff
1- String a;
2+ late String a;
3void main(List<String> args) {
4  a = '123';
5  print(a);
6}

如果将变量标记为 late，但在其声明时对其进行初始化，则初始值设定项会在首次使用该变量时运行。这种惰性初始化在以下几种情况下非常方便：

  • 变量不一定会被使用，那么这种初始化非常节省内存

    dart
    1// This is the program's only call to _readThermometer().
2late String temperature = _readThermometer(); // Lazily initialized.

    上面的代码中，如果temperature变量一直没有被使用，那么_readThermometer函数不会被调用

  • 实例变量没有被初始化，但是又需要访问实例变量的时候添加 late

    dart
    1class Cache {
2  late String name;
3  void setName(String name) {
4    this.name = name;
5  }
6}

    上面的代码中，由于没有构造函数，那么实例时，name 属性并不会被初始化，这时候访问它会报错

    dart
    1  var m = new Cache();
2  // ❌LateInitializationError: Field 'name' has not been initialized.
3  print(m.name);

库

使用 import 来指定命名空间以便其它库可以访问。

import 的唯一参数是用于指定代码库的 URI。

对于 Dart 内置的库，使用 dart:xxxxxx 的形式。

对于其它的库，你可以使用一个文件系统路径或者以 package:xxxxxx 的形式。 package:xxxxxx 指定的库通过包管理器（比如 pub 工具）来提供。

dart
1import 'dart:math'; // 引入内置 math 库
2import 'package:test/test.dart'; // 引入包管理器中的库
3import 'lib/test.dart'; // 引入自己写的库

package 包

下载package使用需要在根目录手动创建pubspec.yaml文件，类似 npm 的 package.json,这是用来管理包的版本和依赖的。

创建后根据提示写入以下内容：

yaml
1name: my_app
2environment:
3  sdk: '>=2.12.0 <3.0.0'

然后可以去这个网站查可以使用的包。

以 http 模块为例：

下载包

只有 dart 就用这个命令

bash
1$ dart pub add http

有 flutter 就用这个命令

bash
1$ flutter pub add http

上面的命令会在pubspec.yaml中增加版本依赖，并且隐式运行dart pub get or flutter pub get

yaml
1dependencies:
2  http: ^0.13.4

使用包

dart
1import 'package:http/http.dart' as http;

库冲突

如果导入的两个代码库有同样的命名，则可以使用指定前缀as。比如如果 library1 和 library2 都有 Element 类，那么可以这么处理：

dart
1import 'package:lib1/lib1.dart';
2import 'package:lib2/lib2.dart' as lib2;
3
4// Uses Element from lib1.
5Element element1 = Element();
6
7// Uses Element from lib2.
8lib2.Element element2 = lib2.Element();

部分导入

如果只想使用代码库的一部分，可以使用部分导入。

dart
1// Import only foo.
2import 'package:lib1/lib1.dart' show foo;
3
4// Import all names EXCEPT foo.
5import 'package:lib2/lib2.dart' hide foo;

export

使用 export 关键字导出

dart
1export 'package:lib1/lib1.dart';
2export 'src/middleware.dart' show Middleware, createMiddleware;

延迟加载

延迟加载（也常称为 懒加载）是有需要的时候再去加载。

目前只有 dart2js 支持延迟加载 Flutter、Dart VM 以及 DartDevc 目前都不支持延迟加载

使用 deferred as 关键字来标识需要延时加载的代码库

dart
1import 'package:greetings/hello.dart' deferred as hello;

当实际需要使用库的 API 时先调用loadLibrary函数加载库：

dart
1Future<void> greet() async {
2  await hello.loadLibrary();
3  hello.printGreeting();
4}

使用 await 关键字暂停代码执行直到库加载完成。loadLibrary 函数可以调用多次也没关系，代码库只会被加载一次。

当你使用延迟加载的时候需要牢记以下几点：

  • 延迟加载的代码库中的常量需要在代码库被加载的时候才会导入，未加载时是不会导入的。
  • 导入文件的时候无法使用延迟加载库中的类型。如果你需要使用类型，则考虑把接口类型转移到另一个库中然后让两个库都分别导入这个接口库。
  • Dart 会隐式地将 loadLibrary() 导入到使用了 deferred as *命名空间* 的类中。 loadLibrary() 函数返回的是一个 Future。

包管理建议

如果我们有实现自己的代码库，为了提升性能，应该将代码放到/lib/src目录下，然后在/lib目录导出src目录内的 API，实现对lib/src 目录中 API 的公开。

异步

Future

Future 跟 JavaScript 的 Promise 差不多，要使用async和await来让代码变成异步的。必须在带有 async 关键字的 异步函数 中使用 await：

dart
1Future<void> checkVersion() async {
2  var version = await lookUpVersion();
3  // Do something with version
4}

上面的代码会等到lookUpVersion处理完成，再执行下一步操作。

await 表达式的返回值通常是一个 Future 对象；如果不是的话也会自动将其包裹在一个 Future 对象里。 Future 对象代表一个“承诺”， await 表达式会阻塞直到需要的对象返回。

async 关键字

跟 JavaScript 的规则差不多，单单使用async只能生成 Future 对象，并不会让代码变成异步的。举个 🌰

dart
1  Future<void> checkVersion() async {
2    print(123);
3  }
4	checkVersion();
5  print(456);
6	// 123
7	// 456

上面的代码并不会让checkVersion变成异步代码，因为 123 在 456 前面打印了。

如果加上 await 就可以对代码进行阻塞，使其变成真正的异步代码。

dart
1  Future<int> getVersion() async => 123;
2
3  Future<void> checkVersion() async {
4    print(0); //这里还是同步代码
5    var res = await getVersion(); //这里开始变成异步
6    print(res);
7  }
8
9  checkVersion();
10  print(456);

上面的结果是

zsh
10
2456
3123

异常处理

使用 try、catch 以及 finally 来处理使用 await 导致的异常：

dart
1try {
2  version = await lookUpVersion();
3} catch (e) {
4  // React to inability to look up the version
5}

Typedefs

typedefs 是类型别名，是一种引用某一类型的简便方法，常用于封装类型，它使用 typedef 关键字。

比如项目中有一个类型是数字类型的 List，我们将它封装起来变成一个类型别名,就可以直接使用

dart
1typedef IntList = List<int>;
2
3IntList a = [1, 2, 3];

当传参是函数并且需要明确的类型定义时，使用类型别名可以简化代码

dart
1  void PrintString(String getS(String str)) {
2    print(getString('name'));
3  }

上面的PrintString函数需要传入一个返回值和参数都为 String 的函数，使用typedef简化代码：

dart
1typedef GetString = String Function(String str);
2
3 void PrintString(GetString getS) {
4    print(getString('name'));
5  }