Flutter文本编辑异常：点击条目编辑时BottomModalSheet报索引错误且内容未填充

问题根源分析 #

你的代码中索引错误和内容不填充的核心问题集中在实际索引查找逻辑和列表对象引用匹配上：

1. 当currentList是_toDoItem的过滤副本（比如通过where生成新列表），currentList[index]的对象与_toDoItem中的对象可能是不同引用，导致_toDoItem.indexOf(item)返回-1，后续用该索引访问_toDoItem直接触发越界错误。
2. 即使是同一引用，若列表存在重复内容，indexOf只会返回第一个匹配项的索引，导致编辑错误条目。

具体解决办法 #

1. 改用唯一标识查找实际索引 #

如果每个待办项有唯一ID字段，直接用ID匹配索引（最可靠的方式）：

void onEditTap(int index, BuildContext context) {
    final currentList = _showCompleted ? completedItems : uncompletedItems;

    if (index < 0 || index >= currentList.length) {
      print("Invalid index for current list: $index");
      return;
    }

    final item = currentList[index];
    // 用唯一ID查找实际索引
    final actualIndex = _toDoItem.indexWhere((element) => element['id'] == item['id']);

    if (actualIndex == -1) {
      print("Item not found in main list: $item");
      return;
    }

    print("Editing Item at Actual Index $actualIndex: ${_toDoItem[actualIndex]}");
    _isTextEditing = true;
    _editingIndex = actualIndex;
    
    _modalTextController.text = _toDoItem[actualIndex]["text"];

    fabKey.currentState?.showModalForEditing(
      context,
      isEditing: true,
      initialText: _toDoItem[actualIndex]["text"],
    );
    notifyListeners();
}

如果没有ID，可临时用内容+状态组合匹配（不推荐长期使用，建议尽快加唯一ID）：

final actualIndex = _toDoItem.indexWhere((element) => 
  element['text'] == item['text'] && 
  element['isCompleted'] == item['isCompleted']
);

2. 直接传递实际索引，避免二次查找 #

在构建列表项时，直接获取并传递_toDoItem中的实际索引，跳过过滤列表的索引转换：

// 示例ListView构建代码
ListView.builder(
  itemCount: currentList.length,
  itemBuilder: (context, index) {
    // 提前获取实际索引
    final actualIndex = _toDoItem.indexWhere((element) => element['id'] == currentList[index]['id']);
    return ListTile(
      onTap: () => onEditTap(actualIndex, context), // 直接传实际索引
      title: Text(currentList[index]['text']),
    );
  },
)

此时onEditTap可简化为直接使用实际索引，省去过滤列表的判断逻辑。

3. 检查Modal中TextField的初始化逻辑 #

确保BottomModalSheet内的TextField正确接收初始化值：

• 如果使用controller：确保传递的_modalTextController已正确设置文本，且Modal内的TextField绑定该controller。
• 如果使用initialValue：确保Modal的initialText参数正确传递并赋值给TextField的initialValue（注意：controller和initialValue不能同时使用，否则initialValue会被忽略）。

示例Modal内的TextField代码：

TextField(
  controller: _modalTextController,
  decoration: InputDecoration(hintText: "编辑待办内容"),
)

4. 增加日志快速定位问题 #

在关键节点打印日志，确认变量值是否符合预期：

print("currentList长度: ${currentList.length}, 点击索引: $index");
print("当前项内容: $item");
print("实际索引: $actualIndex, 主列表长度: ${_toDoItem.length}");

内容的提问来源于stack exchange，提问作者Shakirullah