flutter pub add tuple基于插件公开信息、社区数据与项目使用情况整理的选型参考。
元组包为 Dart 提供了一种轻量级、类型安全的元组数据结构，可将多个可能类型不同的值组合成一个单一的不可变对象。它最多支持 7 个元素，并提供了直观的语法用于创建、访问和解构。该库设计简洁且性能优异，在无需定义自定义类的情况下，能够清晰地返回或传递多个相关值。该库特别适用于函数式编程模式以及需要简洁数据聚合的场景。
以下为关联源码仓库的 README 原文快照，最新内容请访问源码仓库。
A library providing a tuple data structure.
We consider this package to be feature complete. With Dart 3.0, users now have the ability to use Records:
Records are an anonymous, immutable, aggregate type. Like other collection types, they let you bundle multiple objects into a single object.
var record = (123, true);
print('${record.$1}: ${record.$2}');
By and large, Records serve the same use cases that package:tuple had been
used for. New users coming to this package should likely look at using Dart
Records instead. Existing uses of package:tuple will continue to work, however
we don't intend to enhance the functionality of this package; we will continue
to maintain this package from the POV of bug fixes.
const t = Tuple2<String, int>('a', 10);
print(t.item1); // prints 'a'
print(t.item2); // prints '10'
const t1 = Tuple2<String, int>('a', 10);
final t2 = t1.withItem1('c');
// t2 is a new [Tuple2] object with item1 is 'c' and item2 is 10.