如何让 QListView 支持多选？一个真正能落地的实战指南
你有没有遇到过这样的场景：用户想从一堆文件里勾几个删掉，或者在播放列表中批量添加歌曲——结果点了第一个，之前选中的就没了。这种“单选式多选”体验，别说用户了，连你自己都看不下去。
问题出在哪？往往不是逻辑复杂，而是对 Qt 的模型-视图机制理解得不够透。
今天我们就来彻底搞明白一件事：如何用QListView实现一套稳定、顺滑、符合直觉的多选功能。不讲虚的，只说你在写代码时真正会踩的坑和必须知道的细节。
从一个小实验开始：为什么默认只能选一项？
我们先写一段最简单的代码：
QStringList data = {"Item 1", "Item 2", "Item 3"}; QStringListModel *model = new QStringListModel(data, this); QListView *listView = new QListView(this); listView->setModel(model);运行起来后你会发现，无论怎么点，一次只能选中一个项目。这是怎么回事？
答案藏在QListView的默认设置里。它虽然天生支持多种选择模式，但出厂设置是保守的——默认为单选模式（SingleSelection）。
也就是说，多选不是“要实现的功能”，而是“需要主动开启的行为”。
那怎么开？一句话：
listView->setSelectionMode(QAbstractItemView::ExtendedSelection);就这么简单？没错。但这背后有一套完整的协作体系在支撑，搞不清这套体系，后面迟早出问题。
核心三剑客：视图、模型、选择模型
Qt 的模型-视图架构听起来高大上，其实本质就是三个角色各司其职：
| 角色 | 职责 |
|---|---|
| 视图（View） | 负责画出来、响应点击滚动这些操作 |
| 模型（Model） | 管数据本身，比如有多少项、每项叫什么 |
| 选择模型（Selection Model） | 单独管“哪些被选中了”，不碰数据也不负责绘制 |
这三者通过指针关联，彼此解耦。你可以把同一个模型挂到多个视图上，也可以换不同的选择策略而不影响数据。
关键在于：当你调用setSelectionMode()的时候，其实是告诉视图：“请用某种方式去更新选择模型里的索引集合。”
所以，真正的多选流程是这样的：
1. 用户 Ctrl+点击某一项 → 视图捕获事件
2. 视图根据当前 selection mode 计算新旧选区的变化 → 修改 selection model 中的选中索引
3. selection model 发出selectionChanged()信号
4. 其他组件可以监听这个信号，去做后续处理（比如更新状态栏）
整个过程，模型本身的数据一点没动，只是“谁被选中”这个状态变了。
多选模式怎么选？别再乱用了
setSelectionMode()接收一个枚举值，常见的有四个选项。很多人随便选一个MultiSelection就完事，结果用户体验奇差。我们来逐个拆解：
✅ 推荐使用：ExtendedSelection
这才是我们熟悉的“资源管理器式”多选：
- 按住Ctrl可以逐个勾选/取消
- 按住Shift可以快速选中区间
- 鼠标拖拽也能框选（如果启用了）
listView->setSelectionMode(QAbstractItemView::ExtendedSelection);绝大多数场景都应该用这个。
⚠️ 特殊用途：MultiSelection
这个模式允许你直接点击来增减选中项，不需要按 Ctrl。听起来方便？其实很容易误操作。比如你想切换选中项，结果不小心变成了累加选择。
适用于那种“明确希望用户不断点击添加”的场景，比如标签选择器。
❌ 几乎不用：ContiguousSelection
只能选连续的一段。如果你看到用户 Shift 点两头却选不全，可能就是误设成了这个模式。
除非你在做时间轴或波形图这类特殊控件，否则基本不会用到。
一句话总结：想要专业级交互体验？认准
ExtendedSelection。
别忘了设置选择行为：整行还是单格？
另一个常被忽略的配置是：
listView->setSelectionBehavior(QAbstractItemView::SelectRows);这是什么意思？
想象一下表格中有三列，现在你要选中某一行。你是只想点亮那个单元格，还是整行都高亮？
对于QListView这种一维列表来说，当然是整行更合理。否则视觉反馈太弱，用户都不知道到底选没选上。
所以建议统一加上这一句，提升可读性。
怎么拿到用户选了哪些项？
有了多选界面，下一步自然是获取结果。核心接口在这里：
QItemSelectionModel *sm = listView->selectionModel(); QModelIndexList indexes = sm->selectedIndexes();注意！这里返回的是QModelIndexList，但它不是按顺序排列的！
比如你先选第5项，再选第2项，那么列表里就是[5, 2]。如果你打算遍历删除对应数据，就必须倒序处理，否则会因为前面删掉导致后面的索引偏移。
正确的做法：
// 倒序排序，确保从后往前删 std::sort(indexes.begin(), indexes.end(), std::greater<QModelIndex>()); QStringListModel *model = static_cast<QStringListModel*>(listView->model()); for (const QModelIndex &idx : indexes) { model->removeRow(idx.row()); }重要提示：每次删除都会触发视图重绘，如果一次性删很多行，建议用
beginRemoveRows()/endRemoveRows()批量操作，性能更好。
实战案例：做一个带 Delete 删除的文件列表
假设我们要做一个类似文件浏览器的功能，支持：
- 显示文件名列表
- 多选 + Delete 键删除
- 删除前弹确认框
- 状态栏显示已选数量
来看看关键部分怎么写。
第一步：搭建基础 UI
// 数据模型 QStringList files = {"readme.txt", "config.ini", "logo.png", "main.cpp", "CMakeLists.txt"}; QStringListModel *fileModel = new QStringListModel(files, this); // 视图配置 QListView *fileList = new QListView(this); fileList->setModel(fileModel); fileList->setSelectionMode(QAbstractItemView::ExtendedSelection); fileList->setSelectionBehavior(QAbstractItemView::SelectRows); fileList->setFocusPolicy(Qt::StrongFocus); // 必须有焦点才能接收按键第二步：监听 Delete 键
不能直接 connectkeyPressEvent，因为事件可能被拦截。推荐做法是安装事件过滤器：
fileList->installEventFilter(this);然后在主窗口中实现eventFilter：
bool MainWindow::eventFilter(QObject *obj, QEvent *event) { if (obj == fileList && event->type() == QEvent::KeyPress) { QKeyEvent *keyEv = static_cast<QKeyEvent*>(event); if (keyEv->key() == Qt::Key_Delete) { handleDeleteFiles(); // 调用删除逻辑 return true; // 吃掉事件 } } return QMainWindow::eventFilter(obj, event); }第三步：执行删除并反馈
void MainWindow::handleDeleteFiles() { QItemSelectionModel *sm = fileList->selectionModel(); QModelIndexList selected = sm->selectedIndexes(); if (selected.isEmpty()) return; // 弹确认框 int ret = QMessageBox::warning( this, "确认删除", QString("即将删除 %1 个项目，确定吗？").arg(selected.size()), QMessageBox::Ok | QMessageBox::Cancel ); if (ret != QMessageBox::Ok) return; // 倒序删除 std::sort(selected.begin(), selected.end(), std::greater<QModelIndex>()); QStringListModel *model = static_cast<QStringListModel*>(fileList->model()); for (const QModelIndex &idx : selected) { model->removeRow(idx.row()); } // 更新状态栏 statusBar()->showMessage(QString("已删除 %1 个文件").arg(selected.size()), 3000); }搞定。现在你的列表已经具备完整生产力工具的基本素质了。
容易翻车的几个坑，提前告诉你
1. 忘记给视图设焦点策略
如果你发现按 Delete 没反应，第一件事检查：
listView->setFocusPolicy(Qt::StrongFocus);否则控件无法获得键盘输入焦点。
2. 不验证索引有效性
在访问index.data()前，最好判断一下：
if (!index.isValid()) continue;特别是在异步加载或动态删除时，可能会出现无效索引。
3. 忽视样式反馈
默认选中颜色可能不够明显。可以用 QSS 微调：
listView->setStyleSheet(R"( QListView::item:selected { background-color: #3a8ee6; color: white; border-radius: 4px; } )");小小的视觉优化，能让用户体验上升一个档次。
4. 大数据量下的性能问题
如果列表超过几千条，记得开启：
listView->setUniformItemSizes(true);告诉 Qt 所有 item 高度一致，这样滚动时不需要反复计算布局，帧率立刻提升。
写在最后：多选只是起点
掌握了QListView的多选机制，你其实已经摸到了 Qt 模型-视图架构的大门。
接下来你可以轻松扩展出更多高级功能：
- 拖拽排序（启用setDragEnabled(true)和setDragDropMode）
- 右键菜单批量操作
- 异步加载远程数据并保持选择状态
- 结合QSortFilterProxyModel实现搜索过滤仍保留原选中项
而这一切的基础，都是你现在亲手配好的那一行：
listView->setSelectionMode(QAbstractItemView::ExtendedSelection);技术从来不怕简单，怕的是知其然不知其所以然。当你下次看到别人写的列表只能单选时，你会知道，那不是一个功能缺失，而是一次认知跃迁的机会。
如果你正在做的项目也需要类似的交互设计，欢迎留言交流具体场景，我们可以一起探讨更优解法。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
