简介面向 Qt 中级开发者的一款表格控件实战示例围绕 QTableView 与 QAbstractItemModel 协调工作的方式完整演示了自定义模型、动态添加删除行、表头排序以及基于代理模型的数据过滤等核心功能。压缩包内含 22 个文件以 cpp 源文件、h 头文件为主并配有 ui 界面文件、qss 样式表、png 图标以及 pro/qrc 工程配置文件便于直接编译运行并对照学习。资源整体约 18KB体量轻量、结构清晰但覆盖了从模型层、委托层到视图层的完整实现链路。已有 560 人学习下载适合作为快速理解 Qt 模型/视图架构的入门参考。通过研读源码可以掌握 insertRows/removeRows 的扩展方法、sort 排序接口的重载思路、filterAcceptsRow 的过滤规则编写以及基于 QStyledItemDelegate 在单元格内嵌入按钮的交互设计对开发数据管理类程序有明确的借鉴价值也可作为课程设计或项目起步的模板。1. TableViewDemo一次把 QTableView 的模型、委托、样式讲透TableViewDemo 是我在 Qt 表格开发里见过最省事的起步包之一。当时接手一个内部工单系统表格还是默认灰底白字点击单元格没有校验滚动几百条记录直接发飘想加一列字段得在界面代码里翻半天。这份 Demo 把 QTableView 的模型、委托、排序过滤和右键菜单串成一条完整链路照着改就能落到业务里。适合刚学 Qt 的人看结构也适合维护老项目的熟手把它当排查手册。下面按我自己拆包的顺序从模型层一路讲到委托、交互和翻车现场。2. 模型选择从 QStandardItemModel 到自定义 QAbstractTableModel数据源决定表格上限2.1 Model/View 解耦这件事直接决定你后期改不改得动在 Qt 里QTableView 本身不穿数据它只负责把 model 给定的内容画出来。单元格的文本、对齐、背景、可编辑状态全部来自模型层。很多新手图方便直接把数据指针塞进控件再取出来临时能跑后期加一列、加一次排序过滤代码就成了一坨需要在三个文件里同时改的硬逻辑。QStandardItemModel 是自带的标准模型用起来最简单new 一个 Item 塞进去表头也直接 set。它的优点是调试友好、适合静态小表缺点是每个单元格都是一个 QStandardItem 对象几千行开外内存会明显上涨而且没有任何业务校验逻辑。真到设备台账、交易流水这种结构化数据场景更推荐自己写 QAbstractTableModel 子类。TableViewDemo 最值得抄的正好是这一层抽象。它把模型单独拆成类界面只负责 setModel 和连接信号数据变更都发生在模型内部。这样后面再做导出、筛选、批量更新操作的都是同一份数据源不会出现表格显示和业务数据各改各的情况。2.2 自定义 QAbstractTableModel只重写四个方法也能跑起来自定义模型真正必须实现的只有 rowCount、columnCount、data 三个方法再加 headerData 就能把表头显示出来。要支持编辑就在 flags 里开放标记并在 setData 里接受写入。下面是一份设备信息的模型骨架四个字段分别是设备名、类型、状态、状态码也是后台列表那种常见的基础形状。class DeviceTableModel : public QAbstractTableModel { Q_OBJECT public: struct DeviceInfo { QString name; QString type; QString status; int code 0; }; explicit DeviceTableModel(QObject *parent nullptr) : QAbstractTableModel(parent) {} int rowCount(const QModelIndex parent QModelIndex()) const override { if (parent.isValid()) return 0; return int(m_devices.size()); } int columnCount(const QModelIndex parent QModelIndex()) const override { if (parent.isValid()) return 0; return 4; } QVariant data(const QModelIndex index, int role Qt::DisplayRole) const override { if (!index.isValid() || index.row() int(m_devices.size())) return {}; const DeviceInfo d m_devices[index.row()]; if (role Qt::DisplayRole || role Qt::EditRole) { switch (index.column()) { case 0: return d.name; case 1: return d.type; case 2: return d.status; case 3: return d.code; } } else if (role Qt::TextAlignmentRole index.column() 3) { return Qt::AlignCenter; } return {}; } void addDevice(const DeviceInfo info) { beginInsertRows(QModelIndex(), int(m_devices.size()), int(m_devices.size())); m_devices.append(info); endInsertRows(); } private: QVectorDeviceInfo m_devices; };逻辑说明rowCount 返回当前数据条数parent 判断是为了将来扩展树形结构时不至于把子节点行数也返回出去Table 模型里 parent 通常是无效索引直接返回 0 问题也不大。columnCount 固定 4 列列名由 headerData 补充。data 把 DisplayRole 和 EditRole 一起返回保证显示值和编辑框预填值一致状态码列单独给了居中角色让数字列看起来整齐。参数说明beginInsertRows 接收三个参数第一参数在无父节点时传 QModelIndex()后面两个 int 是插入区间比如向空表插入第一条就传 (0,0)。endInsertRows 必须紧跟在后绝不能放进 if 分支否则模型内部状态没闭合后续所有行操作都会错乱。headerData 的参考实现也一并给出在 section 小于 4 时返回对应标题即可QVariant headerData(int section, Qt::Orientation orientation, int role) const override { if (orientation Qt::Horizontal role Qt::DisplayRole) { const QStringList headers {u设备名_qs, u类型_qs, u状态_qs, u状态码_qs}; if (section 0 section headers.size()) return headers.at(section); } return {}; }这个函数返回 QVariant直接用 QString 初始化即可。表头高度和背景后续交给 QSS 处理模型层只保证文字正确。2.3 刷新不是整表 resetdataChanged 比谁都好使实际项目里最常翻车的不是写模型而是“数据变了怎么通知表格”。新手最容易用 beginResetModel 和 endResetModel这两个兄弟一上场整个视图把所有缓存丢掉重新取数据滚动条回到顶部正在编辑的框直接消失大表还伴随白屏闪烁。正确做法按变更类型分三类增行用 beginInsertRows/endInsertRows删行用 beginRemoveRows/endRemoveRows改值用 dataChanged。下面这段是修改设备状态的典型写法void DeviceTableModel::updateStatus(int row, const QString status) { if (row 0 || row int(m_devices.size())) return; m_devices[row].status status; QModelIndex topLeft index(row, 0); QModelIndex bottomRight index(row, columnCount() - 1); emit dataChanged(topLeft, bottomRight, {Qt::DisplayRole, Qt::EditRole}); }逻辑说明dataChanged 接收一个区域这里是整行的第一列到最后一列视图只重绘这块区域。第三个参数 roles 是 QList 限定哪些角色需要重新读取。列表里放了 DisplayRole 和 EditRole界面显示和编辑预填都会同步刷新如果是纯显示表只传 DisplayRole 就够。参数说明topLeft 和 bottomRight 必须是有效索引否则某些发行版会忽略这次信号界面永远不更新。emit 之后不需要手动调用 update()视图内部已经订阅了 dataChanged。一次更新多行时尽量把范围扩大不要循环几百次单行 emit信号风暴对表格性能伤害不小。从信号模型切换到数据驱动的思维是表格性能改善的第一步。3. 委托实践用 QStyledItemDelegate 替换默认编辑框做带校验的下拉列3.1 为什么默认 delegate 不够用四个方法才是入口委托是 Model/View 体系里负责渲染和编辑的组件。QTableView 默认自带一个 QStyledItemDelegate每个可编辑单元格就是一个 QLineEdit文本随便敲回车写回模型没有任何校验。业务里最常见的状态列、优先级列、日期列默认编辑器根本接不住。自定义委托通常只重写四个方法createEditor 决定编辑器控件setEditorData 把模型当前值灌进编辑器setModelData 把编辑结果写回模型updateEditorGeometry 决定编辑器在视图里的位置。四个方法配合起来才是一个完整的编辑闭环。TableViewDemo 里最典型的就是状态列下拉委托。它把编辑框换成 QComboBox选项固定用户只能选不能敲。下面这份代码可以整段抄进工程里用class StatusDelegate : public QStyledItemDelegate { Q_OBJECT public: explicit StatusDelegate(QObject *parent nullptr) : QStyledItemDelegate(parent) {} QWidget *createEditor(QWidget *parent, const QStyleOptionViewItem option, const QModelIndex index) const override { Q_UNUSED(option); Q_UNUSED(index); auto *combo new QComboBox(parent); combo-addItems({u待处理_qs, u处理中_qs, u已完成_qs, u关闭_qs}); return combo; } void setEditorData(QWidget *editor, const QModelIndex index) const override { auto *combo qobject_castQComboBox *(editor); if (!combo) return; int i combo-findText(index.data(Qt::EditRole).toString()); if (i 0) combo-setCurrentIndex(i); } void setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex index) const override { auto *combo qobject_castQComboBox *(editor); if (!combo) return; const QString value combo-currentText(); if (value.isEmpty()) return; model-setData(index, value, Qt::EditRole); } void updateEditorGeometry(QWidget *editor, const QStyleOptionViewItem option, const QModelIndex index) const override { Q_UNUSED(index); editor-setGeometry(option.rect); } };逻辑说明createEditor 返回一个 QComboBox选项写死成四种状态。setEditorData 里用 findText 而不是 setCurrentText是为了防止模型里存了非法值时 combo 自动新增一个错误选项。setModelData 只在选项非空时写回最后统一用 Qt::EditRole 走模型 setData让模型层再做一次校验。参数说明updateEditorGeometry 直接使用 option.rect这是视图根据当前滚动位置计算好的单元格矩形。如果这里自己拼坐标滚动后编辑器位置就会错位。在 createEditor 里 Q_UNUSED 掉 option 和 index 是因为这两个参数在某些编辑器里用不上但签名必须保持编译期不会警告。把上面的类接到表格上只需要一行ui-tableView-setItemDelegateForColumn(2, new StatusDelegate(this));。如果希望整表都用这个委托就换成 setItemDelegate。注意这里 index.column() 对应的是视图列号列结构不调整时和模型列号一致。注意QComboBox 不要擅自 setEditable(true)一旦允许输入用户敲进去的自定义文本就会绕过固定选项委托的“只允许固定状态”性质就名存实亡。3.2 委托不只是下拉setData 校验是最容易被跳过的一环下拉委托只是把控件换了最后一道关卡还在模型里。QAbstractTableModel 默认的 setData 返回 false任何 delegate 写回都会被拒绝。遇到“委托不生效”“双击没反应”的情况一半原因在编辑器没建出来另一半就是 setData 没实现。常见做法是在自定义模型里补上 flags 和 setData。flags 告诉视图哪些列可编辑setData 告诉视图写入是否成功。下面是配套模型的写法Qt::ItemFlags DeviceTableModel::flags(const QModelIndex index) const { Qt::ItemFlags f QAbstractTableModel::flags(index); if (index.isValid() index.column() ! 3) f | Qt::ItemIsEditable; return f; } bool DeviceTableModel::setData(const QModelIndex index, const QVariant value, int role) { if (!index.isValid() || role ! Qt::EditRole) return false; if (index.column() 3) { bool ok false; int code value.toInt(ok); if (!ok || code 0 || code 5000) return false; m_devices[index.row()].code code; } else { m_devices[index.row()].name value.toString(); } emit dataChanged(index, index, {Qt::DisplayRole, Qt::EditRole}); return true; }逻辑说明flags 里对状态码列下标 3不加 Editable这列只读setData 只接受 EditRole 写入第 4 列先转 int 再校验范围校验不过直接返回 false不让非法值进入内部数据。真正赋值动作发生在校验之后最后用 dataChanged 告知视图刷新这样委托写回、模型校验、界面更新三个步骤有了统一的出口。参数说明setData 的返回值直接控制编辑流程是否继续。返回 false 时视图认定写入失败编辑器会保持或重新弹出如果你发现编辑框一直闪优先怀疑校验和角色匹配。另外 roles 列表里没必要放 Qt::DisplayRole 以外的值放多了只会让视图多取几次数据不会更可靠。3.3 样式表把默认灰底表格改成能看的样子模型和委托把行为定好了接下来是观感。QTableView 默认外观很朴素表头又矮又灰选中单元格是纯色块。TableViewDemo 里给了一段 QSS核心点在于分别定制表格区域、表头、选中态和交替行背景。QTableView { gridline-color: #d8dde3; selection-background-color: #dfebf7; selection-color: #1c2a44; alternate-background-color: #f4f6f8; } QTableView::item { padding: 4px 8px; border-bottom: 1px solid #e5e8ec; } QHeaderView::section { height: 32px; background: #eef1f4; border: none; border-right: 1px solid #d0d5db; padding-left: 8px; }逻辑说明selection-background-color 控制选中背景配 selection-color 换文本色比默认蓝底白字更柔和。alternate-background-color 只是给了候选色还必须同时调用 view-setAlternatingRowColors(true) 才会逐行交替生效单写 QSS 不调用开关是没用的。参数说明QHeaderView::section 里的 height 写在 QSS 中可以直接定死表头高度。在代码里想改表头高度用 setFixedHeight 不会稳定生效得通过 setMinimumHeight 和 setMaximumHeight 同时约束。多种样式叠加时注意 QSS 的优先级高于 palette别在调色板里改了老半天没有反应。4. 交互增强排序、过滤与右键菜单让表格从“显示”变成“可用”4.1 QSortFilterProxyModel排序过滤不碰原始数据表格能显示能编辑之后紧接着就是排序和过滤。直接对模型里的数据排序不是不行但会破坏原始顺序过滤和多列排序都很难受。标准做法是在视图和源模型之间加一个 QSortFilterProxyModel视图只跟代理交互源数据保持原样。装配只有三步新建代理、setSourceModel 挂源模型、view-setModel 挂代理。之后排序、过滤都在代理层完成。这样做的好处是导出数据时源模型顺序不乱别的视图依赖的原始顺序也不受影响。auto *proxy new QSortFilterProxyModel(this); proxy-setSourceModel(deviceModel); proxy-setDynamicSortFilter(true); ui-tableView-setModel(proxy); ui-tableView-setSortingEnabled(true); ui-tableView-horizontalHeader()-setSortIndicatorShown(true); ui-tableView-sortByColumn(0, Qt::AscendingOrder);逻辑说明setDynamicSortFilter(true) 表示源模型数据一变化代理立刻重新排序和过滤视图保持同步。sortByColumn 是主动触发的排序第一次加载时可以直接把默认排序列定下来不用让用户先点什么才排。参数说明sortByColumn 第一个参数是代理模型的列号列结构没变时和源模型列号一致。sortingEnabled 打开后用户点击表头就能换排序如果你不想让用户乱排就只调 sortByColumn 而不要开这个开关。还有一个小坑字符串排序默认按字典序“10”会排在“2”前面。数字列要排对需要继承代理重写 lessThan或者把模型里对应角色的 QVariant 转成数值再比较。4.2 自定义过滤组合条件比 setFilterFixedString 更实用过滤的初级用法是 setFilterFixedString(关键字)一行代码完事。但真实业务通常要“设备类型等于处理中且名称包含服”这种下拉框加输入框的组合条件必须重写 filterAcceptsRow。class DeviceFilterProxy : public QSortFilterProxyModel { Q_OBJECT public: void setTypeFilter(const QString type) { m_type type.trimmed(); invalidateRowsFilter(); } void setNameKeyword(const QString kw) { m_keyword kw.trimmed(); invalidateRowsFilter(); } protected: bool filterAcceptsRow(int sourceRow, const QModelIndex sourceParent) const override { const QModelIndex typeIdx sourceModel()-index(sourceRow, 1, sourceParent); const QModelIndex nameIdx sourceModel()-index(sourceRow, 0, sourceParent); const QString type sourceModel()-data(typeIdx).toString(); const QString name sourceModel()-data(nameIdx).toString(); if (!m_type.isEmpty() type ! m_type) return false; if (!m_keyword.isEmpty() !name.contains(m_keyword, Qt::CaseInsensitive)) return false; return true; } private: QString m_type; QString m_keyword; };逻辑说明filterAcceptsRow 的参数是源模型的行号必须用这个 sourceRow 去源模型取数据不能用代理的行号否则过滤状态下会取错。搜索关键词用 contains 而不是相等判断再配合 Qt::CaseInsensitive 忽略大小写用户体验会比较自然。两个条件同时为空时返回 true相当于不过滤。参数说明invalidateRowsFilter 会通知代理把所有行重新过一遍过滤条件调用时机是外部条件变化时。这里对输入做了 trimmed把首尾空格去掉避免用户误敲一个空格把所有数据滤空。如果需要正则过滤新版 Qt 用 setFilterRegularExpression 替代 setFilterRegExp旧的 QRegExp 头文件在 Qt6 里已经被移走混用会直接编译报错。4.3 右键菜单菜单动作和当前行联动表格交互里右键菜单几乎是标配。常见做法是先把表格的 contextMenuPolicy 设成 Qt::CustomContextMenu再连接 customContextMenuRequested 信号。这个信号的参数是视图坐标先用 indexAt 转成模型索引再判断是否落在有效行上。ui-tableView-setContextMenuPolicy(Qt::CustomContextMenu); connect(ui-tableView, QTableView::customContextMenuRequested, this, [this](const QPoint pos) { QModelIndex viewIdx ui-tableView-indexAt(pos); QModelIndex srcIdx viewIdx.isValid() ? static_castQSortFilterProxyModel *(ui-tableView-model())-mapToSource(viewIdx) : QModelIndex(); QMenu menu(this); QAction *editAct menu.addAction(u修改状态_qs); QAction *exportAct menu.addAction(u导出本行_qs); menu.addSeparator(); QAction *delAct menu.addAction(u删除设备_qs); QAction *chosen menu.exec(ui-tableView-viewport()-mapToGlobal(pos)); if (!chosen || !srcIdx.isValid()) return; if (chosen editAct) { ui-tableView-edit(viewIdx); } else if (chosen exportAct) { exportRow(srcIdx.row()); } else if (chosen delAct) { deviceModel-removeRow(srcIdx.row()); } });逻辑说明indexAt 拿到的是代理模型的索引排序后 proxy 行号不等于源模型行号所以这里通过 mapToSource 做了一次映射。所有涉及源模型的操作比如删除、导出业务数据都用 srcIdx涉及视图操作比如进入编辑状态用 viewIdx。这两个索引各管各的事不能混。参数说明menu.exec 的参数是全局坐标pos 相对于 viewport所以外面包了 viewport()-mapToGlobal(pos)不能直接用控件的 mapToGlobal。chosen 指向被选中的动作通过指针比较决定走哪个分支。删除动作要生效前提是自定义模型实现了 removeRows否则菜单弹出来了但数据纹丝不动。5. 避坑与排查TableView 常见问题的六个翻车现场这一章专门记录我在 TableView 上踩过的坑。每一条都按现象、原因、解决三个维度来理希望能帮你少走几轮弯路。前几条是从模型层往视图层排的越往后越接近业务代码遇到类似现象可以直接跳着看。5.1 表头不显示或列标题错位现象跑起来后界面上没有列标题或者用户拖动列后标题挂到别的列上。原因没有重写 headerData或者 headerData 里只处理了 Qt::DisplayRole 却忘了返回列名。拖动列后错位是因为 headerData 的 section 参数对应模型列号而视图的视觉列号可能被用户拖乱此时再按 section 去取数据就会拿错。解决先确认 headerData 返回了非空字符串再检查是不是把表头隐藏了。隐藏表头用 horizontalHeader()-setVisible(false)不要用 setHidden后者在某些样式下会留下一截空白。列位置被用户拖动后如果需要根据视觉列取数据先调用 horizontalHeader()-visualIndex() 拿到映射再回源模型不要直接拿可见位置当模型列号。5.2 数据一变化整张表白屏闪烁滚动条跳回顶部现象修改一个单元格的状态整张表立刻重画滚动位置回到最开始屏幕闪一下白。原因模型里的更新函数用了 beginResetModel 和 endResetModel。这两个函数设计用来通知视图“整体结构变了”视图收到后会把所有缓存丢弃全部重新取数滚动条也会归零。单元格值变化根本用不上重置。解决只在列数变更或全量数据替换时用 reset。单行单值变化改用 dataChanged行增删用 beginInsertRows/beginRemoveRows。排查时可以临时在更新函数里数一下信号类型如果一次修改触发了几十次 reset那基本上就是通知粒度放太大了。多个连续行更新把 dataChanged 的区域扩大到最小行和最大行减少信号数量。5.3 双击单元格不编辑委托的下拉框不弹出来现象双击单元格像没反应或者委托设置了但编辑器一直不出现。原因模型 flags 里没有开放 ItemIsEditable视图认为这一列不可编辑自然不会启动委托也有可能是 setItemDelegate 全局委托把之前 setItemDelegateForColumn 的列委托盖掉了。解决先判断是哪一层的问题。在 model 里临时输出 index.flags().testFlag(Qt::ItemIsEditable)是 false 就到 flags 里补标记。委托覆盖问题建议一张表只统一用 setItemDelegate 或只统一用 setItemDelegateForColumn不要两套混用。最后再检查 createEditor 返回的编辑器指针是不是 nullptr某些错误分支会返回空视图会直接放弃编辑。5.4 排序之后右键删除删错行现象表格按名称排序后右键点击某一行删除界面里删掉的却是另一行。原因右键菜单里拿到的 viewIdx 是代理模型索引。排序后视觉第一行对应的源模型可能是第三十行直接把这个索引传给源模型的 removeRow等于按代理行号删源模型数据必然错位。解决所有业务操作入参统一用源模型行号。拿到 viewIdx 后先走 proxy-mapToSource(viewIdx) 再传给模型方法这个习惯一旦养成排序、过滤、拖拽都不会再出删错行的问题。调试时分别打印 viewIdx.row() 和 srcIdx.row()能直观看到两套行号在排序状态下差距有多大。5.5 从文本文件读中文变乱码现象表格显示内容出现“锟斤拷”“烫烫烫”从 CSV 读进来的设备名全是乱码。原因源文件是 GBK 编码程序在 Qt6 里默认按 UTF-8 解码。最稳的读法不是 QString::fromLocal8Bit而是用 QTextStream 显式声明编码优先处理 BOM 情况。解决项目内部文件统一 UTF-8。外部 CSV 没有编码标记读入时先看 BOM 再决定解码方式。QTextStream 在 Qt6 里 setCodec 改名成 setEncoding参数变成 QStringConverter 枚举老代码迁移到 Qt6 时这里会卡住。下面这段是兼容 Qt5/Qt6 的读法QFile f(path); if (!f.open(QIODevice::ReadOnly)) return; QTextStream in(f); #if QT_VERSION QT_VERSION_CHECK(6, 0, 0) in.setEncoding(QStringConverter::Utf8); #else in.setCodec(UTF-8); #endif while (!in.atEnd()) { const QString line in.readLine(); // 按业务拆分单元格 }逻辑说明代码先打开文件再按 Qt 大版本选择 API。Qt6 用 setEncoding 接收 QStringConverter::Utf8Qt5 用 setCodec 接收字符串编码名。条件编译让同一份源码两代 Qt 都能编译。读行循环里拿到的是 QString后续按分隔符 split 即可。参数说明setEncoding 的参数是编码枚举不要传字符串“utf-8”Qt6 里类型对不上。如果文件带 BOMQTextStream 会自动跳过 BOM 头不必额外处理。导出端也建议统一用同一编码否则电子表格软件打开中文 CSV 又会出现另一套乱码。5.6 编辑框弹一下就退出输入字符闪回现象进入编辑状态后每敲一个字符编辑器就收起再弹起内容写不进去。原因setData 返回 false 时视图判定写入失败会尝试重新进入编辑状态。常见诱因是角色不匹配——委托写回时用了 Qt::EditRole模型 setData 里只认 Qt::DisplayRole两边对不上就总是拒绝另一种是校验过严把中间状态当非法值拦住了。解决统一约定自定义委托写回一律传 Qt::EditRole模型 setData 只校验 EditRole 这一个入口。弹编辑器时可以先在 setData 开头打日志看清进来时的 role 到底是什么。想给用户提示时不要直接在 setData 里弹框委托层先做基本校验不合格就弹提示并返回模型层只负责最终拦截这样界面不会出现焦点打架。6. 进阶拖拽行排序与 CSV 导出向真实业务再靠近一步6.1 拖拽行排序表格手动排序是工单、清单类业务的高频需求。先通知视图开启拖拽模式ui-tableView-setDragDropMode(QAbstractItemView::InternalMove); ui-tableView-setDefaultDropAction(Qt::MoveAction); ui-tableView-setDragDropOverwriteMode(false);逻辑说明InternalMove 让视图在内部移动行数据模型本身需要配合实现 moveRows否则拖拽只是视觉变化。setDragDropOverwriteMode(false) 是为了避免移动时把目标行的内容覆盖掉防止拖到一半数据丢失。参数说明这三个参数互相配合少一个都可能出现能拖不能放的诡异现象。如果源模型没实现 moveRows拖完之后重启界面又回到原顺序不用怀疑控件换数据层。6.2 CSV 导出导出比导入简单但编码问题同样会反咬一口。电子表格软件对无 BOM 的 UTF-8 文件有时会按本地编码猜中文内容一打开就乱。最省事的方案是直接导出带 BOM 的 UTF-8或者用系统默认编码。下面这个函数按 UTF-8 输出void exportModelToCsv(QAbstractItemModel *model, const QString filePath) { QFile f(filePath); if (!f.open(QIODevice::WriteOnly | QIODevice::Text)) return; QTextStream out(f); #if QT_VERSION QT_VERSION_CHECK(6, 0, 0) out.setEncoding(QStringConverter::Utf8); #else out.setCodec(UTF-8); #endif for (int r 0; r model-rowCount(); r) { QStringList cells; for (int c 0; c model-columnCount(); c) cells model-index(r, c).data().toString(); out cells.join(u,) u\n; } }逻辑说明双层循环把模型所有单元格导出成 CSV 文本。这里用的是代理模型指针导出顺序和用户看到的一致如果想导原始顺序传入源模型即可。数据里带逗号时电子表格软件会把单元格拆开需要在 join 前对每个字段加引号包裹。double 类型用 toString 转出来可能带尾差建议业务层格式化后再写入。参数说明setEncoding 和 setCodec 的分支与前面读文件一样。QIODevice::Text 标志在 Windows 下会自动处理换行符不要省掉。从那以后我每接一个 TableView 工程都强制先走一遍同样的流程确认模型职责边界、检查代理映射、验证委托角色最后再看 QSS。这份 Demo 包的代码片段正好可以作为这条流程的对照清单希望帮到你。本文还有配套的精品资源点击获取