Flutter CupertinoPicker多实例初始值异常继承前序选中索引如何解决

这个问题本质是三个常见的CupertinoPicker使用错误导致的：

• 多个选择器共用了同一个FixedExtentScrollController实例，导致前一个选择器的滚动位置被复用给后一个选择器
• 所有选择器的选中索引绑定到了同一个状态变量上，前一个选择器的选中值覆盖了后一个的预设初始值
• 手动设置的初始索引超过了当前选择器的总选项长度，系统找不到对应选项就会显示为空

1. 为每个选择器单独配置独立的控制器和状态存储 #

不要全局共用同一个控制器或选中状态变量，每个选择器对应专属的控制器和状态，初始化时传入目标初始值对应的索引：

// 错误写法：共用同一个控制器/状态变量
final commonController = FixedExtentScrollController(initialItem: 0);
int selectedIndex = 0;

// 正确写法：每个选择器单独声明
// 年龄选择器相关配置
final ageScrollController = FixedExtentScrollController(initialItem: 20); // 对应默认选中21岁的索引
int selectedAge = 21;
// 重量选择器相关配置
final weightScrollController = FixedExtentScrollController(initialItem: 64); // 对应默认选中65kg的索引
int selectedWeight = 65;
// 性别选择器相关配置
final genderScrollController = FixedExtentScrollController(initialItem: 0); // 对应默认选中第一个性别选项的索引
int selectedGender = 0;

使用时每个CupertinoPicker绑定对应专属的控制器和状态变量即可。

2. 跳转新选择器前校验初始索引合法性 #

切换到下一个选择器之前，先判断你要设置的初始索引是否小于当前选择器的总选项数，避免索引越界：

// 示例：性别选择器只有2个选项，合法索引只能是0或1
int targetGenderIndex = 你要设置的初始索引;
if(targetGenderIndex >= genderOptions.length || targetGenderIndex < 0){
  targetGenderIndex = 0; // 越界时自动 fallback 到第一个选项
}
// 用校验后的合法索引跳转
genderScrollController.jumpToItem(targetGenderIndex);

3. 页面销毁时主动释放所有控制器 #

避免内存泄漏，在dispose生命周期中销毁所有创建的控制器：

@override
void dispose(){
  ageScrollController.dispose();
  weightScrollController.dispose();
  genderScrollController.dispose();
  super.dispose();
}

内容的提问来源于stack exchange，提问作者Nurbek Batyrzhan uulu