Dart 是一种针对客户端优化的语言，用于在任何平台上开发快速应用。 其目标是提供用于多平台开发的最高效的编程语言，并配备用于应用框架的灵活的执行运行时平台。
Hello World
每个应用程序都需要顶级 main() 函数，程序执行从此处开始。不显式返回值的函数具有 void 返回类型。要显示控制台文本，可以使用顶级 print() 函数：
void main() {
print('Hello, World!');
}
变量
即使在类型安全 的 Dart 代码中，您也可以使用 var 声明大多数变量，而无需显式指定它们的类型。由于类型推断，这些变量的类型由它们的初始值确定：
var name = 'Voyager I';
var year = 1977;
var antennaDiameter = 3.7;
var flybyObjects = ['Jupiter', 'Saturn', 'Uranus', 'Neptune'];
var image = {
'tags': ['saturn'],
'url': '//path/to/saturn.jpg'
};
控制流语句
Dart 支持常用的控制流语句：
if (year >= 2001) {
print('21st century');
} else if (year >= 1901) {
print('20th century');
}
for (final object in flybyObjects) {
print(object);
}
for (int month = 1; month <= 12; month++) {
print(month);
}
while (year < 2016) {
year += 1;
}
阅读更多关于 Dart 中控制流语句的信息，包括break 和 continue、switch 和 case 以及assert。
函数
我们建议指定每个函数的参数和返回值的类型：
int fibonacci(int n) {
if (n == 0 || n == 1) return n;
return fibonacci(n - 1) + fibonacci(n - 2);
}
var result = fibonacci(20);
对于包含单个语句的函数，=>（箭头）简写语法非常方便。当将匿名函数作为参数传递时，此语法尤其有用：
flybyObjects.where((name) => name.contains('turn')).forEach(print);
除了显示匿名函数（where() 的参数）之外，此代码还显示您可以将函数用作参数：顶级 print() 函数是 forEach() 的参数。
注释
Dart 注释通常以 // 开头。
// 这是一个普通的单行注释。
/// 这是一个文档注释，用于记录库、类及其成员。IDE 和 dartdoc 等工具会特殊处理文档注释。
/* 也支持这样的注释。 */
导入
要访问在其他库中定义的 API，请使用 import。
// 导入核心库
import 'dart:math';
// 导入外部包的库
import 'package:test/test.dart';
// 导入文件
import 'path/to/my_other_file.dart';
类
这是一个具有三个属性、两个构造函数和一个方法的类的示例。其中一个属性不能直接设置，因此它是使用 getter 方法（而不是变量）定义的。该方法使用字符串插值在字符串文字内打印变量的字符串等效项。
class Spacecraft {
String name;
DateTime? launchDate;
// 只读非 final 属性
int? get launchYear => launchDate?.year;
// 构造函数，具有用于赋值给成员的语法糖。
Spacecraft(this.name, this.launchDate) {
// 初始化代码放在这里。
}
// 将转发到默认构造函数的命名构造函数。
Spacecraft.unlaunched(String name) : this(name, null);
// 方法。
void describe() {
print('Spacecraft: $name');
// 类型提升不适用于 getter。
var launchDate = this.launchDate;
if (launchDate != null) {
int years = DateTime.now().difference(launchDate).inDays ~/ 365;
print('Launched: $launchYear ($years years ago)');
} else {
print('Unlaunched');
}
}
}
您可以像这样使用 Spacecraft 类：
var voyager = Spacecraft('Voyager I', DateTime(1977, 9, 5));
voyager.describe();
var voyager3 = Spacecraft.unlaunched('Voyager III');
voyager3.describe();
枚举
枚举是一种枚举预定义值或实例集的方法，它确保不能存在该类型的任何其他实例。
这是一个简单的 enum 示例，它定义了一个简单的预定义行星类型的列表：
enum PlanetType {
terrestrial, gas, ice }
这是一个描述行星的类的增强型枚举声明示例，它定义了一组常量实例，即我们太阳系中的行星。
/// 枚举我们太阳系中不同的行星及其一些属性。
enum Planet {
mercury(planetType: PlanetType.terrestrial, moons: 0, hasRings: false),
venus(planetType: PlanetType.terrestrial, moons: 0, hasRings: false),
// ···
uranus(planetType: PlanetType.ice, moons: 27, hasRings: true),
neptune(planetType: PlanetType.ice, moons: 14, hasRings: true);
/// 常量生成构造函数
const Planet(
{
required this.planetType, required this.moons, required this.hasRings});
/// 所有实例变量都是 final
final PlanetType planetType;
final int moons;
final bool hasRings;
/// 增强型枚举支持 getter 和其他方法
bool get isGiant =>
planetType == PlanetType.gas || planetType == PlanetType.ice;
}
您可以像这样使用 Planet 枚举：
final yourPlanet = Planet.earth;
if (!yourPlanet.isGiant) {
print('Your planet is not a "giant planet".');
}
继承
Dart 支持单继承。
class Orbiter extends Spacecraft {
double altitude;
Orbiter(super.name, DateTime super.launchDate, this.altitude);
}
Mixin
Mixin 是一种在多个类层次结构中重用代码的方法。以下是 mixin 声明：
mixin Piloted {
int astronauts = 1;
void describeCrew() {
print('Number of astronauts: $astronauts');
}
}
要将 mixin 的功能添加到类中，只需使用 mixin 扩展该类即可。
class PilotedCraft extends Spacecraft [!with!] Piloted {
// ···
}
PilotedCraft 现在具有 astronauts 字段以及 describeCrew() 方法。
接口和抽象类
所有类都隐式定义一个接口。因此，您可以实现任何类。
class MockSpaceship implements Spacecraft {
// ···
}
您可以创建一个抽象类，以便由具体的类扩展（或实现）。抽象类可以包含抽象方法（具有空主体）。
abstract class Describable {
void describe();
void describeWithEmphasis() {
print('=========');
describe();
print('=========');
}
}
任何扩展 Describable 的类都具有 describeWithEmphasis() 方法，该方法调用扩展器对 describe() 的实现。
异步
通过使用 async 和 await，避免回调地狱并使您的代码更具可读性。
const oneSecond = Duration(seconds: 1);
// ···
Future<void> printWithDelay(String message) async {
await Future.delayed(oneSecond);
print(message);
}
上面的方法等同于：
Future<void> printWithDelay(String message) {
return Future.delayed(oneSecond).then((_) {
print(message);
});
}
如下一个示例所示，async 和 await 有助于使异步代码易于阅读。
Future<void> createDescriptions(Iterable<String> objects) async {
for (final object in objects) {
try {
var file = File('$object.txt');
if (await file.exists()) {
var modified = await file.lastModified();
print(
'File for $object already exists. It was modified on $modified.');
continue;
}
await file.create();
await file.writeAsString('Start describing $object in this file.');
} on IOException catch (e) {
print('Cannot create description for $object: $e');
}
}
}
您还可以使用 async*，它为您提供了一种简洁易读的构建流的方法。
Stream<String> report(Spacecraft craft, Iterable<String> objects) async* {
for (final object in objects) {
await Future.delayed(oneSecond);
yield '${craft.name} flies by $object';
}
}
异常
要引发异常，请使用 throw：
if (astronauts == 0) {
throw StateError('No astronauts.');
}
要捕获异常，请使用带有 on 或 catch（或两者兼有）的 try 语句：
Future<void> describeFlybyObjects(List<String> flybyObjects) async {
try {
for (final object in flybyObjects) {
var description = await File('$object.txt').readAsString();
print(description);
}
} [!on IOException catch (e)!] {
print('Could not describe object: $e');
} finally {
flybyObjects.clear();
}
}
注意，上面的代码是异步的；try 适用于同步代码和 async 函数中的代码。
重要概念
在继续学习 Dart 语言时，请记住以下事实和概念：
- 您可以放在变量中的任何内容都是一个 对象 ，并且每个对象都是一个 类 的实例。即使是数字、函数和
null也是对象。除了null（如果您启用了健全空安全）之外，所有对象都继承自Object类。
空安全 在 Dart 2.12 中引入。使用空安全需要至少 2.12 的语言版本。
- 尽管 Dart 是强类型的，但类型注解是可选的，因为 Dart 可以推断类型。在
var number = 101中，number被推断为int类型。 - 如果您启用了空安全，除非您声明它们可以，否则变量不能包含
null。您可以通过在类型的末尾添加问号（?）来使变量可为空。例如，int?类型的变量可能是整数，也可能是null。如果您 知道 某个表达式永远不会计算为null，但 Dart 不同意，您可以添加!来断言它不为null（如果为null则抛出异常）。例如：int x = nullableButNotNullInt! - 当您想显式声明允许任何类型时，请使用
Object?类型（如果您已启用空安全）、Object，或者——如果您必须将类型检查延迟到运行时——特殊类型dynamic。 - Dart 支持泛型类型，例如
List<int>（整数列表）或List<Object>（任何类型的对象的列表）。 - Dart 支持顶级函数（例如
main()），以及与类或对象绑定的函数（分别为 静态 和实例方法）。您也可以在函数中创建函数（ 嵌套 或局部函数）。 - 同样，Dart 支持顶级 变量 ，以及与类或对象绑定的变量（静态变量和实例变量）。实例变量有时被称为 字段 或属性。
- 与 Java 不同，Dart 没有
public、protected和private关键字。如果标识符以下划线（_）开头，则它对其库是私有的。有关详细信息，请参阅库和导入。 - 标识符可以以字母或下划线（
_）开头，后跟任何这些字符加上数字的组合。 - Dart 同时具有 表达式 （具有运行时值）和 语句 （没有值）。例如，条件表达式
condition ? expr1 : expr2的值为expr1或expr2。将其与if-else 语句 进行比较，后者没有值。语句通常包含一个或多个表达式，但表达式不能直接包含语句。 - Dart 工具可以报告两种类型的問題：警告 和 错误。警告只是表明您的代码可能无法正常工作，但它们不会阻止您的程序执行。错误可以是编译时错误或运行时错误。编译时错误会阻止代码完全执行；运行时错误会导致在代码执行期间引发异常。
