为何删除QTreeWidgetItem会自动推进关联QTreeWidget的迭代器？

这确实是Qt里一个没在公开官方文档中明确说明的隐藏行为，我之前做项目时也踩过这个坑，一开始完全摸不着头脑，后来翻了Qt源码才搞清楚背后的逻辑。

背后的实现逻辑 #

Qt的QTreeWidgetItemIterator（包括其他类似的item迭代器）和STL迭代器的设计思路不太一样：

• 当你创建一个QTreeWidgetItemIterator时，它会自动注册到所属的QTreeWidget内部的迭代器列表中。
• 当某个QTreeWidgetItem被析构（不管是你手动delete，还是QTreeWidget在清理时自动删除），item的析构函数会通知关联的QTreeWidget，触发一个迭代器更新流程：
  1. QTreeWidget遍历所有已注册的迭代器
  2. 如果迭代器当前指向的正是要被删除的item，就自动把迭代器推进到下一个有效的item位置
  3. 这样迭代器就不会直接变成无效状态，而是能继续遍历剩下的元素

这种设计其实是Qt为了简化开发者的使用——避免像STL那样删除元素后迭代器直接失效，需要手动处理迭代器的更新。但因为这个行为没有在官方文档里明确提及，所以很容易和我们的预期（迭代器仅失效但不推进）产生偏差。

源码层面的验证 #

你可以去看Qt的源码实现：

• QTreeWidgetItemIterator的构造函数里会调用QTreeWidget::addIterator(this)，把自己加入tree的迭代器管理列表
• QTreeWidgetItem的析构函数会调用QTreeWidget::removeItem(this)，这个方法内部会遍历所有注册的迭代器，检查并更新指向当前item的迭代器

一些使用建议 #

1. 如果你需要依赖这个行为，要注意虽然Qt的多个版本都保持了这个逻辑，但毕竟是未文档化的行为，未来版本有变更的风险，尽量不要过度依赖
2. 如果想避免迭代器自动推进，可以在删除item前手动记录迭代器的位置，删除后重新初始化迭代器或者手动调整位置

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