Dart 语法快速通关：写给 Flutter 开发者的基础教程

// 程序入口：必须是 main 函数，无返回值可省略 void
void main() {
  // 打印语句：Flutter 中调试打印常用 print，等价于 Flutter 的 debugPrint（后者可避免日志截断）
  print("Hello Dart! Hello Flutter!");
}
// 运行方式：1. 终端执行 dart main.dart；2. Android Studio 直接运行

void main() {
  // 1. var：类型推断，声明后类型固定（不可变）
  var name = "Flutter Dev"; // 推断为 String 类型
  name = 123; // 错误：类型不匹配，编译期报错
  
  // 2. dynamic：动态类型，类型和值均可变（慎用，会失去强类型校验）
  dynamic age = 25;
  age = "二十五"; // 合法，但增加运行时风险
  
  // 3. final：值不可变，类型可推断（运行时确定值）
  final height = 1.8; // 推断为 double，值不可修改
  // height = 1.85; // 错误：final 变量不可重新赋值
  
  // 4. const：编译时常量，值和类型均不可变（编译期确定值）
  const pi = 3.14159; // 编译期就确定值，性能优于 final
  const maxWidth = 375.0; // Flutter 中常用 const 声明固定尺寸、颜色等常量
  
  // 注意：Flutter 中，const 修饰的组件会被缓存，减少重建开销（如 const Text("Hello")）
}

void main() {
  // 1. String
  String userName = '张三';
  String multiLineText = """这是多行文本
  适用于 Flutter 中长文本展示场景""";
  print(userName + "，你好"); // 字符串拼接
  print("姓名：$userName"); // 字符串插值（推荐，简洁高效）
  
  // 2. num
  int count = 10; // 商品数量
  double price = 99.9; // 商品价格
  print(count * price); // 数值计算，Flutter 中可用于计算总价、尺寸等
  
  // 3. bool
  bool isLogin = true;
  if (isLogin) {
    print("已登录，展示首页"); // Flutter 中可据此切换登录页/首页
  }
  
  // 4. List（Flutter 高频）
  List<String> goodsList = ["手机", "电脑", "平板"]; // 泛型指定元素类型
  goodsList.add("耳机"); // 添加元素
  print(goodsList[0]); // 访问元素，Flutter 中 ListView.builder 遍历此列表
  
  // 5. Map（解析接口数据常用）
  Map<String, dynamic> userInfo = {
    "id": 1,
    "name": "李四",
    "age": 28
  };
  print(userInfo["name"]); // 访问键值对
}

// 基础函数：计算两个数的和，显式声明返回值类型 int
int add(int a, int b) {
  return a + b;
}

// 带默认参数的函数：Flutter 中组件参数常用默认值（如 Text 的 style 参数）
String getGreeting(String name, String prefix = "Hello") {
  return "$prefix, $name!";
}

// 无返回值函数：可省略返回值类型（默认 void）
void showMessage(String message) {
  print(message);
}

void main() {
  print(add(2, 3)); // 输出 5
  print(getGreeting("Flutter")); // 输出 Hello, Flutter!（使用默认 prefix）
  print(getGreeting("Flutter", "Hi")); // 输出 Hi, Flutter!（自定义 prefix）
  showMessage("函数测试完成");
}

void main() {
  // 基础箭头函数：等价于普通函数的简化形式
  int subtract(int a, int b) => a - b;
  print(subtract(5, 2)); // 输出 3
  
  // Flutter 场景1：列表遍历（List 的 forEach 回调）
  List<String> fruits = ["苹果", "香蕉", "橙子"];
  fruits.forEach((fruit) => print("水果：$fruit"));
  
  // Flutter 场景2：组件事件回调（如 ElevatedButton 的 onPressed）
  // 模拟 ElevatedButton 的点击事件（实际在 Flutter 组件树中使用）
  void onButtonClick() => print("按钮被点击");
  onButtonClick(); // 模拟点击，输出 按钮被点击
  
  // Flutter 场景3：构建简单组件（如 ListView 的 itemBuilder）
  // 模拟构建列表项组件（实际代码）
  // ListView.builder(
  //   itemCount: fruits.length,
  //   itemBuilder: (context, index) => Text(fruits[index]), // 箭头函数构建 Text 组件
  // )
}

// 定义类：Flutter 组件都是这样的类（如 StatelessWidget、StatefulWidget）
class Person {
  // 成员变量（属性）
  String name;
  int age;
  
  // 构造函数（简化写法：Dart 语法糖，等价于赋值语句）
  Person(this.name, this.age);
  
  // 成员方法
  void introduce() {
    print("我叫 $name，今年 $age 岁");
  }
}

void main() {
  // 创建对象：Flutter 中构建组件就是创建类的实例（如 Text("Hello")）
  Person person = Person("王五", 30);
  person.introduce(); // 调用方法，输出 我叫 王五，今年 30 岁
  
  // 修改对象属性
  person.age = 31;
  person.introduce(); // 输出 我叫 王五，今年 31 岁
}

class User {
  String id;
  String name;
  String email;
  
  // 默认构造函数
  User(this.id, this.name, this.email);
  
  // 命名构造函数：从 Map 初始化（解析接口数据常用）
  User.fromMap(Map<String, dynamic> map) {
    id = map["id"];
    name = map["name"];
    email = map["email"];
  }
  
  void showUserInfo() {
    print("ID：$id，姓名：$name，邮箱：$email");
  }
}

void main() {
  // 1. 通过默认构造函数创建
  User user1 = User("1001", "赵六", "zhaoliu@example.com");
  user1.showUserInfo();
  
  // 2. 通过命名构造函数创建（解析接口返回的 Map 数据）
  Map<String, dynamic> userMap = {
    "id": "1002",
    "name": "孙七",
    "email": "sunqi@example.com"
  };
  User user2 = User.fromMap(userMap);
  user2.showUserInfo(); // 输出 ID：1002，姓名：孙七，邮箱：sunqi@example.com
}

// 模拟异步操作：模拟网络请求获取数据（延迟 2 秒）
Future<String> fetchData() {
  // Future.delayed：延迟执行，模拟网络耗时
  return Future.delayed(Duration(seconds: 2), () {
    return "模拟接口返回的数据：Flutter 教程";
  });
}

void main() {
  print("开始请求数据...");
  // 处理 Future：使用 then 接收成功结果，catchError 捕获错误
  fetchData()
      .then((data) {
        print("数据获取成功：$data");
      })
      .catchError((error) {
        print("数据获取失败：$error");
      })
      .whenComplete(() {
        print("请求完成（无论成功/失败）");
      });
  print("请求已发起，等待结果..."); // 此语句会先执行，证明异步特性
}

Future<String> fetchData() {
  return Future.delayed(Duration(seconds: 2), () {
    return "模拟接口返回的数据：Flutter 教程";
  });
}

// 注意：使用 await 的函数必须添加 async 关键字，返回值默认是 Future
void getData() async {
  print("开始请求数据...");
  try {
    // await：等待 Future 完成，获取结果
    String data = await fetchData();
    print("数据获取成功：$data");
  } catch (error) {
    print("数据获取失败：$error");
  } finally {
    print("请求完成（无论成功/失败）");
  }
}

void main() {
  getData();
  print("请求已发起，等待结果...");
}

// 模拟 Flutter 中使用 dio 发起网络请求
// Future<Response> fetchApiData() async {
//   return await Dio().get("https://api.example.com/data");
// }