1
class Stack<T> {                    // ← T 是类型参数
2
  final _items = <T>[];
3
  void push(T item) => _items.add(item);
4
  T pop() => _items.removeLast();
5
  bool get isEmpty => _items.isEmpty;
6
}
7

8
var intStack = Stack<int>();        // T = int
9
intStack.push(42);
10
int value = intStack.pop();        // 返回类型是 int，类型安全
11

12
var stringStack = Stack<String>(); // T = String
13
stringStack.push('hello');
14
String text = stringStack.pop();   // 返回类型是 String

1
List<int> numbers = [1, 2, 3];           // List<T>
2
Map<String, dynamic> json = {};          // Map<K, V>
3
Set<String> tags = {'dart', 'flutter'};  // Set<T>
4
Future<String> data = fetchData();       // Future<T>
5
Stream<int> counter = countUp();         // Stream<T>
6
Completer<void> gate = Completer();      // Completer<T>

1
// 两个类型参数
2
class Pair<A, B> {
3
  final A first;
4
  final B second;
5
  Pair(this.first, this.second);
6

7
  @override
8
  String toString() => '($first, $second)';
9
}
10

11
var pair = Pair<String, int>('age', 25);
12
print(pair.first);   // 'age'（类型是 String）
13
print(pair.second);  // 25（类型是 int）

1
final List<ChatMessage> _messages = [];
2
// 含义：一个列表，元素类型是 ChatMessage

1
Map<String, dynamic>? _user;
2
// 含义：一个可能为 null 的 Map，key 是 String，value 是 dynamic

1
final Map<String, int> _historyRequestOffsets = <String, int>{};
2
// 含义：一个 Map，key 是 String（消息 ID），value 是 int（偏移量）

1
final Map<String, Completer<Map<String, dynamic>>> _pendingResponses = {};

1
Map<                              ← 最外层：Map
2
  String,                         ← Key：消息 ID（字符串）
3
  Completer<                      ← Value：一个 Completer
4
    Map<String, dynamic>          ← Completer 完成时产出的值类型
5
  >
6
>

1
final Map<String, Completer<void>> _historyRequestCompleters = <String, Completer<void>>{};

1
Map<
2
  String,              ← Key：消息 ID
3
  Completer<void>      ← Value：只通知完成，不产出值
4
>

1
final _authRequestController = StreamController<Map<String, dynamic>>.broadcast();

1
StreamController<           ← 控制器
2
  Map<String, dynamic>      ← 流中每个事件的类型：一个 JSON 对象
3
>.broadcast()               ← 广播模式

1
// 从 JSON Map 中安全提取值
2
T? jsonGet<T>(Map<String, dynamic> json, String key) {
3
  final value = json[key];
4
  if (value is T) return value;
5
  return null;
6
}
7

8
// 使用
9
var user = {'name': 'Lumi', 'age': 18};
10
String? name = jsonGet<String>(user, 'name');   // 'Lumi'
11
int? age = jsonGet<int>(user, 'age');            // 18
12
int? missing = jsonGet<int>(user, 'phone');      // null
13
String? wrong = jsonGet<String>(user, 'age');    // null（age 是 int，不是 String）

1
// T 必须是 num 的子类型（int 或 double）
2
T findMax<T extends num>(List<T> list) {
3
  T max = list.first;
4
  for (var item in list) {
5
    if (item > max) max = item;  // ← 因为 T extends num，所以可以用 >
6
  }
7
  return max;
8
}
9

10
findMax<int>([1, 5, 3]);       // ✅ 5
11
findMax<double>([1.1, 5.5]);   // ✅ 5.5
12
// findMax<String>(['a', 'b']); // ❌ 编译错误：String 不是 num 的子类

1
// T 必须实现 Comparable 接口
2
T findMin<T extends Comparable<T>>(List<T> list) {
3
  T min = list.first;
4
  for (var item in list) {
5
    if (item.compareTo(min) < 0) min = item;
6
  }
7
  return min;
8
}
9

10
findMin<int>([3, 1, 2]);           // ✅ int 实现了 Comparable
11
findMin<String>(['c', 'a', 'b']);   // ✅ String 也实现了 Comparable

1
abstract class ThemeExtension<T extends ThemeExtension<T>> {
2
  //                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
3
  //                  T 必须是 ThemeExtension<T> 的子类
4
  //                       （自引用泛型，Curiously Recurring Template Pattern）
5
  T copyWith();
6
  T lerp(T? other, double t);
7
}

1
class LumiColors extends ThemeExtension<LumiColors> {
2
  //                                    ^^^^^^^^^^
3
  //                    T = LumiColors（满足 T extends ThemeExtension<T>）
4

5
  @override
6
  LumiColors copyWith({ ... }) { ... }   // 返回类型是 LumiColors（不是 Object）
7

8
  @override
9
  LumiColors lerp(LumiColors? other, double t) { ... }  // 参数类型也是 LumiColors
10
}

1
// Dart 的泛型集合是协变的
2
List<int> ints = [1, 2, 3];
3
List<num> nums = ints;    // ✅ List<int> 是 List<num> 的子类型（因为 int 是 num 的子类型）
4
List<Object> objs = ints; // ✅ 也行
5

6
// 但这可能导致运行时错误
7
nums.add(3.14);  // 运行时错误！实际是 List<int>，不接受 double

1
// JSON 反序列化时，值的类型不确定，必须用 dynamic
2
final data = jsonDecode(raw) as Map<String, dynamic>;
3
// data['name'] → dynamic（可能是 String、int 或 null）
4
// 需要手动 as 转换
5
final name = data['name'] as String? ?? '';

1
extension IntDuration on int {
2
  Duration get seconds => Duration(seconds: this);
3
  Duration get milliseconds => Duration(milliseconds: this);
4
  Duration get minutes => Duration(minutes: this);
5
}
6

7
// 使用
8
await Future.delayed(3.seconds);     // 3 秒
9
var timeout = 500.milliseconds;      // 500 毫秒
10
var interval = 5.minutes;            // 5 分钟

1
extension StringValidator on String {
2
  bool get isValidUrl => startsWith('http://') || startsWith('https://');
3
}

1
extension on String {
2
  bool get isBlank => trim().isEmpty;
3
}
4
// 匿名 extension 不能被 show/hide，也不能在其他文件中被显式引入

1
static ThemeData dark({String? fontFamily}) {
2
  return ThemeData(
3
    brightness: Brightness.dark,
4
    // ...
5
    extensions: [LumiColors.dark()],   // ← 把自定义颜色注册进去
6
  );
7
}

1
// 通过 Theme.of(context).extension<T>() 获取
2
final colors = Theme.of(context).extension<LumiColors>()!;
3
//                                         ^^^^^^^^^^^
4
//                            泛型参数指定要获取的扩展类型
5

6
// 然后就像访问普通属性一样
7
Container(
8
  color: colors.sidebar,          // 侧边栏背景色
9
  child: Text(
10
    'Hello',
11
    style: TextStyle(color: colors.accent),  // 强调色
12
  ),
13
)

1
// 当用户从深色模式切换到浅色模式时：
2
// Flutter 框架会自动调用 lerp()，在两组颜色之间做平滑过渡
3
// t = 0.0 → 完全是旧主题（dark）
4
// t = 0.5 → 两个主题各一半
5
// t = 1.0 → 完全是新主题（light）
6

7
sidebar: Color.lerp(
8
  Color(0xFF0E1621),  // dark.sidebar
9
  Color(0xFFFFFFFF),  // light.sidebar
10
  t,                  // 0.0 → 1.0 的过渡比例
11
)!,