Qt模型/视图架构深度解析：从MVC对比到自定义Model实战-尧图网络科技

如果你正在准备 Qt 开发岗位的面试，或者在实际项目中需要处理复杂的数据展示与交互，那么“模型/视图架构”这个概念你一定绕不过去。很多开发者，尤其是从传统桌面开发或 Web MVC 框架转过来的，初次接触 Qt 的 Model/View 时，都会产生一个巨大的疑问：这不就是 MVC 吗？为什么 Qt 要搞一套自己的说法？

更实际的问题是，当 Qt 内置的QStandardItemModel无法满足需求，你需要自定义 Model 时，面对QAbstractItemModel那一堆纯虚函数，往往会感到无从下手：到底哪些方法是必须实现的？rowCount()和columnCount()谁先谁后？data()方法里那些奇怪的Qt::ItemDataRole都是干嘛用的？如果这些问题没搞清楚，写出来的自定义 Model 要么性能低下，要么视图显示异常，调试起来更是痛苦。

这篇文章不会仅仅复述官方文档。我们将深入 Qt 模型/视图框架的设计哲学，直击面试和实战中的核心痛点：

彻底厘清Qt Model/View 与传统 MVC 的本质区别，这决定了你如何理解 Qt 的数据驱动 UI 思想。
逐个拆解自定义 Model 必须实现的五个核心方法（rowCount,columnCount,data,index,parent），不仅告诉你“要写什么”，更讲清楚“为什么这么写”以及“写错了会怎样”。
通过一个从零构建的树形数据模型示例，将理论转化为可运行、可调试的代码，让你真正掌握自定义 Model 的完整流程和最佳实践。

无论你是为了应对下一次技术面试，还是为了在项目中构建一个高效、可维护的数据展示层，理解这些内容都将让你事半功倍。

1. 模型/视图架构：Qt 对 MVC 的“改良”而非“照搬”

在深入代码之前，我们必须先建立正确的认知：Qt 的模型/视图框架是对经典 MVC 模式的一种解耦和优化，其核心目标是将数据管理与用户界面彻底分离。

1.1 经典 MVC 模式回顾

在传统的 MVC（Model-View-Controller）中，三者职责明确但耦合度相对较高：

Model（模型）：管理应用程序的数据和业务逻辑。
View（视图）：将数据以特定形式呈现给用户。
Controller（控制器）：接收用户输入，并调用 Model 和 View 来完成业务请求。它像是 Model 和 View 之间的“协调员”。

在有些实现中，View 会直接监听 Model 的变化（如观察者模式），但 Controller 仍然需要处理大量的界面逻辑和更新指令。

1.2 Qt Model/View 的颠覆性设计

Qt 的框架保留了 Model 和 View，但彻底重构了“Controller”的角色和交互方式，形成了更清晰、更高效的架构。

组件	经典 MVC 中的角色	Qt Model/View 中的角色	关键变化
Model	管理数据与业务逻辑。	唯一的数据源。职责高度内聚： 1. 存储数据。 2. 通过标准接口 (`QAbstractItemModel`) 向 View 提供数据。 3.主动通知View 数据的变化。	接口标准化，成为被观察者。
View	呈现数据，有时会包含一些展示逻辑。	纯粹的数据呈现器。职责单一： 1. 从 Model拉取数据并渲染。 2. 将用户交互（点击、编辑）委托给Delegate处理。 3. 不持有或修改数据。	与 Model 解耦，通过标准接口获取数据。
Controller	处理用户输入，更新 Model 和 View。	被拆解和替代： 1.用户输入：由 View 接收。 2.交互逻辑：大部分交给了Delegate。 3.数据更新：通过调用 Model 的`setData()`等方法实现。	Controller 的功能被 View 和 Delegate 分担，概念被弱化。
Delegate	通常不是独立组件。	新增的核心组件。负责： 1.渲染定制：如何绘制一个数据项（如进度条、复选框）。 2.编辑控制：当用户编辑一个数据项时，提供合适的编辑器（如文本框、下拉框）并将结果写回 Model。	将 View 的显示逻辑和编辑逻辑剥离，实现了更灵活的界面定制。

用一个简单的类比来理解：

经典 MVC像是一家餐厅：顾客（用户）向服务员（Controller）点菜，服务员告诉后厨（Model）做什么，后厨做好后，服务员再把菜端给顾客（View）。服务员全程协调。
Qt Model/View更像是现代化的自助餐系统：菜品（Model）整齐地摆放在餐台上，并自带保温灯（数据变化信号）。顾客（View）自己拿取菜品（拉取数据），餐台旁有厨师（Delegate）可以为你现场切肉或煎蛋（定制渲染与编辑）。系统的核心是那个标准化、自带通知功能的餐台（Model）。

1.3 为什么这个区别如此重要？

理解这个区别，能帮你避开两个常见的开发误区：

在 View 里操作数据：想着“我点了这个列表项，就在对应的事件处理函数里修改数据吧”。这是 MVC 的思维。在 Qt 中，正确做法是获取该数据项的 Model Index，然后调用 Model 的setData()方法。数据更新的入口只能是 Model。
自定义 Model 时忽略信号：只实现了data()方法返回数据，但数据改变后视图不更新。因为你忘了 Qt 的 View 是依赖 Model 的dataChanged()等信号来被动更新的。Model 必须在其数据发生任何改变时，主动发射相应的信号。

这种架构带来了巨大的优势：一个 Model 可以同时被多个不同的 View 显示（例如，同一份数据同时用表格和树形展示），且任何 View 的修改都会通过 Model 同步到所有其他 View。这极大地提高了代码的复用性和数据的一致性。

2. 自定义 Model 的基石：QAbstractItemModel 与核心方法

当 Qt 内置的QStandardItemModel（适用于简单动态数据）或QFileSystemModel（适用于文件系统）不能满足你特定数据结构的需求时，你就需要自定义 Model。而这一切的起点是QAbstractItemModel这个抽象基类。

2.1 必须实现的五个核心方法

QAbstractItemModel定义了许多接口，但对于一个能工作的、最基本的自定义 Model，你必须实现以下五个纯虚函数。它们是 View 用来探索和获取数据的“导航图”和“数据源”。

2.1.1`rowCount(const QModelIndex &parent)`与`columnCount(const QModelIndex &parent)`

作用：告诉 View，在给定的parent索引下，有多少行和多少列数据。
关键理解：
- parent参数标识了一个父项。如果parent是无效的 (!parent.isValid())，则表示请求的是根项的行列数（例如，表格的总行数，或树形结构的顶级节点数）。
- 如果parent有效，则表示请求的是该父项子项的行列数（例如，树形结构中某个节点下的子节点数）。
- 对于列表（一维数据），通常columnCount固定返回 1。
- 对于表格（二维数据），columnCount可能返回一个固定值（如表格的列数）。
- 对于树，行列数的概念被灵活运用：每个父项下的子项被视为一行，而列数通常固定，用于显示该节点的不同属性（如文件名、大小、修改日期）。

2.1.2`data(const QModelIndex &index, int role)`

作用：这是 Model 的核心数据提供方法。根据给定的index（数据项的位置）和role（数据的角色），返回对应的数据。
关键理解：
- index：包含了行、列和父节点信息，唯一标识一个数据项。
- role：这是一个Qt::ItemDataRole枚举值，定义了请求数据的用途。这是 Qt Model/View 非常精妙的设计，它让同一个数据项可以根据不同场景返回不同形式的数据。
- 必须处理Qt::DisplayRole：这是最基本角色，View 用它来获取显示在界面上的文本。
- 常用角色：
  - Qt::DisplayRole：显示的文本。
  - Qt::EditRole：编辑时使用的数据（可能与显示数据不同，如数字的格式化显示与原始值）。
  - Qt::ToolTipRole：鼠标悬停提示。
  - Qt::TextAlignmentRole：文本对齐方式。
  - Qt::BackgroundRole/ForegroundRole：背景色/前景色。
  - Qt::CheckStateRole：用于显示复选框状态。
- 对于不支持的role，应返回一个无效的QVariant()。

2.1.3`index(int row, int column, const QModelIndex &parent)`

作用：根据行、列和父索引，创建或返回一个对应的QModelIndex对象。这是 View 在内部遍历数据结构的“导航”方法。
关键理解：
- View 需要定位数据时（比如用户滚动到了新区域），它会调用此方法，询问：“在parent节点下，第row行、第column列的数据索引是什么？”
- 你必须检查row和column是否在有效范围内（根据parent节点下的rowCount和columnCount）。
- 如果有效，你需要创建一个QModelIndex并返回。通常使用createIndex(row, column, internalPointer)来创建。
- internalPointer是一个void*类型的参数，它可以用来存储一个指向你内部数据对象的指针。这是连接QModelIndex与你实际数据的关键桥梁。对于简单模型，可以传nullptr；对于树形或复杂模型，通常传入指向对应数据节点的指针。

2.1.4`parent(const QModelIndex &child)`

作用：返回给定子索引child的父索引。
关键理解：
- 对于列表或表格（平坦结构），任何数据项的父项都是根，因此此方法应始终返回一个无效的QModelIndex()。
- 对于树形结构，这是必须正确实现的关键方法。你需要根据child索引中的internalPointer（或你存储的其他信息）找到其对应的数据节点，然后找到该节点的父节点，最后为这个父节点创建并返回一个QModelIndex。
- 如果child本身就是顶级节点（根节点的子节点），那么它的父节点是根，此方法也应返回无效的QModelIndex()。

2.2 可选但至关重要的方法：`setData`与`flags`

要让 Model 支持编辑，还需要实现：

setData(const QModelIndex &index, const QVariant &value, int role)：将value以指定的role写入index对应的数据项。成功返回true，并在数据改变后必须发射dataChanged(index, index)信号，通知所有关联的 View 更新。
flags(const QModelIndex &index)：返回数据项的属性标志。例如，要支持编辑，需要包含Qt::ItemIsEditable；要支持选择，需要包含Qt::ItemIsSelectable。默认实现通常返回Qt::ItemIsEnabled | Qt::ItemIsSelectable。

3. 实战：构建一个自定义树形文件系统模型

理论说得再多，不如一行代码。下面我们实现一个简化的树形模型，它模拟一个文件目录结构，每个节点有名称、类型和大小三个属性。我们将看到上述五个核心方法如何协同工作。

3.1 定义内部数据结构

首先，定义我们自己的数据节点类。

// File: treenode.h #ifndef TREENODE_H #define TREENODE_H #include <QList> #include <QString> class TreeNode { public: enum NodeType { Folder, File }; TreeNode(NodeType type, const QString &name, qint64 size = 0, TreeNode *parent = nullptr); ~TreeNode(); void appendChild(TreeNode *child); TreeNode *child(int row); int childCount() const; int row() const; // 返回自己在父节点中的行序 TreeNode *parentNode(); NodeType type; QString name; qint64 size; // 仅文件有大小，文件夹为0 private: TreeNode *m_parent; QList<TreeNode*> m_children; }; #endif // TREENODE_H

// File: treenode.cpp #include "treenode.h" TreeNode::TreeNode(NodeType type, const QString &name, qint64 size, TreeNode *parent) : type(type), name(name), size(size), m_parent(parent) { } TreeNode::~TreeNode() { qDeleteAll(m_children); } void TreeNode::appendChild(TreeNode *child) { child->m_parent = this; m_children.append(child); } TreeNode *TreeNode::child(int row) { if (row < 0 || row >= m_children.size()) return nullptr; return m_children.at(row); } int TreeNode::childCount() const { return m_children.size(); } int TreeNode::row() const { if (m_parent) { // 在父节点的子列表中查找自己的位置 return m_parent->m_children.indexOf(const_cast<TreeNode*>(this)); } return 0; // 根节点的行号无意义，通常返回0 } TreeNode *TreeNode::parentNode() { return m_parent; }

3.2 实现自定义模型

现在，实现继承自QAbstractItemModel的自定义模型。

// File: customtreemodel.h #ifndef CUSTOMTREEMODEL_H #define CUSTOMTREEMODEL_H #include <QAbstractItemModel> #include "treenode.h" class CustomTreeModel : public QAbstractItemModel { Q_OBJECT public: explicit CustomTreeModel(QObject *parent = nullptr); ~CustomTreeModel(); // 必须实现的五个核心接口 QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override; QModelIndex parent(const QModelIndex &child) const override; int rowCount(const QModelIndex &parent = QModelIndex()) const override; int columnCount(const QModelIndex &parent = QModelIndex()) const override; QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; // 可选但重要的接口：支持编辑和设置表头 QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const override; bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole) override; Qt::ItemFlags flags(const QModelIndex &index) const override; // 用于构建和修改模型数据的公共方法 void setupModelData(); // 初始化示例数据 private: TreeNode *rootNode; // 根节点，其数据不显示，仅作为所有顶级节点的父节点 }; #endif // CUSTOMTREEMODEL_H

// File: customtreemodel.cpp #include "customtreemodel.h" #include <QIcon> CustomTreeModel::CustomTreeModel(QObject *parent) : QAbstractItemModel(parent) { rootNode = new TreeNode(TreeNode::Folder, "Root"); setupModelData(); } CustomTreeModel::~CustomTreeModel() { delete rootNode; } // 核心方法1: 创建索引 QModelIndex CustomTreeModel::index(int row, int column, const QModelIndex &parent) const { if (!hasIndex(row, column, parent)) return QModelIndex(); TreeNode *parentNode; if (!parent.isValid()) { // 父索引无效，请求的是根节点下的子节点（即顶级节点） parentNode = rootNode; } else { // 通过 internalPointer 获取父节点对象 parentNode = static_cast<TreeNode*>(parent.internalPointer()); } // 获取父节点下第 row 行的子节点 TreeNode *childNode = parentNode->child(row); if (childNode) { // 创建索引，并将子节点的指针存入 internalPointer return createIndex(row, column, childNode); } return QModelIndex(); } // 核心方法2: 获取父索引 QModelIndex CustomTreeModel::parent(const QModelIndex &child) const { if (!child.isValid()) return QModelIndex(); TreeNode *childNode = static_cast<TreeNode*>(child.internalPointer()); TreeNode *parentNode = childNode->parentNode(); if (parentNode == rootNode || parentNode == nullptr) { // 如果父节点是根节点，则返回无效索引（表示顶级节点） return QModelIndex(); } // 为父节点创建索引。需要知道父节点在其父节点中的行号。 return createIndex(parentNode->row(), 0, parentNode); } // 核心方法3: 行数 int CustomTreeModel::rowCount(const QModelIndex &parent) const { TreeNode *parentNode; if (parent.column() > 0) // 通常只关心第0列的行结构 return 0; if (!parent.isValid()) { parentNode = rootNode; } else { parentNode = static_cast<TreeNode*>(parent.internalPointer()); } return parentNode->childCount(); } // 核心方法4: 列数 int CustomTreeModel::columnCount(const QModelIndex &parent) const { Q_UNUSED(parent); return 3; // 我们的模型有三列：名称、类型、大小 } // 核心方法5: 提供数据 QVariant CustomTreeModel::data(const QModelIndex &index, int role) const { if (!index.isValid()) return QVariant(); TreeNode *node = static_cast<TreeNode*>(index.internalPointer()); int column = index.column(); if (role == Qt::DisplayRole || role == Qt::EditRole) { switch (column) { case 0: // 名称列 return node->name; case 1: // 类型列 return (node->type == TreeNode::Folder) ? "文件夹" : "文件"; case 2: // 大小列 if (node->type == TreeNode::File) { return QString("%1 KB").arg(node->size); } else { return QVariant(); // 文件夹不显示大小 } default: break; } } // 可以添加其他角色，例如图标 else if (role == Qt::DecorationRole && column == 0) { if (node->type == TreeNode::Folder) { return QIcon(":/icons/folder.png"); // 假设有资源文件 } else { return QIcon(":/icons/file.png"); } } // 文本对齐 else if (role == Qt::TextAlignmentRole && column == 2) { return Qt::AlignRight; // 大小列右对齐 } return QVariant(); } // 设置表头数据 QVariant CustomTreeModel::headerData(int section, Qt::Orientation orientation, int role) const { if (orientation == Qt::Horizontal && role == Qt::DisplayRole) { switch (section) { case 0: return "名称"; case 1: return "类型"; case 2: return "大小"; default: break; } } return QVariant(); } // 支持编辑：设置标志位 Qt::ItemFlags CustomTreeModel::flags(const QModelIndex &index) const { if (!index.isValid()) return Qt::NoItemFlags; Qt::ItemFlags flags = QAbstractItemModel::flags(index); // 让第一列（名称）可编辑 if (index.column() == 0) { flags |= Qt::ItemIsEditable; } return flags; } // 支持编辑：写入数据 bool CustomTreeModel::setData(const QModelIndex &index, const QVariant &value, int role) { if (!index.isValid() || role != Qt::EditRole) return false; TreeNode *node = static_cast<TreeNode*>(index.internalPointer()); if (index.column() == 0) { node->name = value.toString(); // 关键步骤：数据改变后，必须发射 dataChanged 信号 emit dataChanged(index, index, {role}); return true; } return false; } // 初始化示例数据 void CustomTreeModel::setupModelData() { TreeNode *docFolder = new TreeNode(TreeNode::Folder, "文档", 0, rootNode); TreeNode *picFolder = new TreeNode(TreeNode::Folder, "图片", 0, rootNode); rootNode->appendChild(docFolder); rootNode->appendChild(picFolder); docFolder->appendChild(new TreeNode(TreeNode::File, "报告.doc", 256, docFolder)); docFolder->appendChild(new TreeNode(TreeNode::File, "笔记.txt", 128, docFolder)); TreeNode *vacationFolder = new TreeNode(TreeNode::Folder, "假期", 0, picFolder); picFolder->appendChild(vacationFolder); vacationFolder->appendChild(new TreeNode(TreeNode::File, "海滩.jpg", 2048, vacationFolder)); vacationFolder->appendChild(new TreeNode(TreeNode::File, "山峰.png", 4096, vacationFolder)); }

3.3 在 View 中使用模型

最后，我们在主窗口中创建一个QTreeView并使用我们的自定义模型。

// File: mainwindow.cpp (部分关键代码) #include "mainwindow.h" #include "ui_mainwindow.h" #include "customtreemodel.h" #include <QTreeView> #include <QVBoxLayout> MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) , ui(new Ui::MainWindow) { ui->setupUi(this); // 1. 创建模型 CustomTreeModel *model = new CustomTreeModel(this); // 2. 创建视图 QTreeView *treeView = new QTreeView(this); treeView->setModel(model); // 关键：将模型设置给视图 treeView->setAlternatingRowColors(true); // 设置交替行颜色，方便查看 treeView->setEditTriggers(QAbstractItemView::DoubleClicked | QAbstractItemView::EditKeyPressed); // 允许编辑 // 3. 将视图设置到窗口中心 setCentralWidget(treeView); // 4. 展开所有节点，方便查看 treeView->expandAll(); } MainWindow::~MainWindow() { delete ui; }

<!-- File: CMakeLists.txt (示例) --> cmake_minimum_required(VERSION 3.16) project(CustomModelDemo) set(CMAKE_CXX_STANDARD 17) set(CMAKE_AUTOMOC ON) set(CMAKE_AUTORCC ON) set(CMAKE_AUTOUIC ON) find_package(Qt6 REQUIRED COMPONENTS Core Widgets) qt_add_executable(${PROJECT_NAME} main.cpp mainwindow.cpp mainwindow.h mainwindow.ui customtreemodel.cpp customtreemodel.h treenode.cpp treenode.h ) target_link_libraries(${PROJECT_NAME} Qt6::Core Qt6::Widgets)

4. 运行与验证：理解数据流动

编译并运行上述程序，你将看到一个树形视图，展示了我们初始化的目录结构。

关键交互验证：

数据展示：视图正确显示了名称、类型和大小三列。文件夹和文件显示了不同的图标（如果资源存在）。
树形结构：你可以展开和折叠“文档”、“图片”及其下的“假期”文件夹，这证明了index()和parent()方法正确建立了节点间的层次关系。
编辑功能：双击第一列（名称）下的任何一项，你可以对其进行编辑。修改后按回车，数据会更新。这证明了flags()和setData()方法工作正常，并且dataChanged信号被正确发射，驱动了视图的更新。

这个简单的例子，完整地演示了 Qt 模型/视图框架的数据流：

初始化：View 调用rowCount()和columnCount()了解数据结构。
渲染：为了填充界面，View 反复调用index()和data()来获取每个单元格的索引和显示内容。
导航：当你展开一个节点时，View 会为这个节点（作为父节点）调用rowCount()获取其子节点数，然后为每个子节点调用index()和data()。
更新：当你编辑并回车时，View 调用setData()。模型更新内部数据（TreeNode::name）并发射dataChanged信号。View 接收到信号后，重新向 Model 请求该索引的data()，从而更新显示。

5. 自定义 Model 的进阶与最佳实践

掌握了基本实现后，要构建一个健壮、高效的自定义 Model，还需要注意以下几点：

5.1 性能优化：懒加载与批量更新

懒加载数据：如果数据量巨大（如文件系统），不要在构造函数中加载所有数据。可以在rowCount()或data()被首次调用时，动态加载当前层级的数据。

批量更新：如果需要插入、删除或移动多行，不要逐行操作并发射信号。使用beginInsertRows(),endInsertRows(),beginRemoveRows(),endRemoveRows()等封装函数。这些函数会向 View 发送一个“批量操作开始/结束”的信号，让 View 可以进行优化（如暂停渲染），从而大幅提升性能。

void CustomTreeModel::insertFolder(TreeNode *parent, int position) { int row = position; beginInsertRows(createIndexForNode(parent), row, row); // 通知视图 TreeNode *newNode = new TreeNode(TreeNode::Folder, "新建文件夹", 0, parent); parent->insertChild(row, newNode); // 操作内部数据 endInsertRows(); // 操作结束，视图更新 }

5.2 正确处理信号

Model 是主动方，必须在其数据状态改变时通知 View。除了dataChanged，还有：

layoutChanged()：当模型的结构发生重大变化（如排序、大量数据刷新），且无法用增删行信号描述时使用。它会通知所有关联的 View 重新加载数据。
headerDataChanged()：当表头数据变化时使用。
rowsInserted(),rowsRemoved()等：通常由beginInsertRows()/endInsertRows()等辅助函数自动发射。

5.3 关于`QModelIndex`和`internalPointer`

QModelIndex是一个轻量级的、临时的数据句柄。它包含行、列、父索引信息以及一个void*指针 (internalPointer)。
internalPointer是你将模型索引与你内部数据结构（如TreeNode*）关联起来的唯一纽带。务必确保在模型的整个生命周期内，这个指针是有效的。
不要在QModelIndex中存储复杂数据或需要清理的资源，它只应存储指针或标识符。

5.4 选择正确的基类

QAbstractListModel：适用于一维列表数据。只需实现rowCount()和data()，index()和parent()已有默认实现。
QAbstractTableModel：适用于二维表格数据。同样简化了index()和parent()。
QAbstractItemModel：适用于任意复杂的层次化数据（树形）。功能最全，但需要实现的方法也最多。根据你的数据结构复杂度选择合适的起点，可以节省大量工作。

6. 常见问题与排查思路

在实现和使用自定义 Model 时，以下是一些典型问题及解决方法：

问题现象	可能原因	排查方式	解决方案
视图一片空白，不显示任何数据	1.`rowCount()`/`columnCount()`返回 0。 2.`data()`方法对`Qt::DisplayRole`总是返回无效`QVariant()`。 3. 模型对象未被正确初始化或已提前销毁。	1. 在`rowCount()`和`columnCount()`中设置断点或打印日志。 2. 检查`data()`方法中`role`的判断逻辑。 3. 检查模型对象的生命周期，确保其在视图使用期间有效。	1. 确保根节点下确有数据。 2. 确保`data()`方法处理了`Qt::DisplayRole`。 3. 将模型对象设置为视图的父对象，或使用智能指针管理其生命周期。
树形视图无法展开，或展开后显示错误数据	1.`index()`方法实现错误，返回了无效索引。 2.`parent()`方法实现错误，父节点关系混乱。 3.`rowCount()`对于非叶子节点返回了 0。	1. 在`index()`中检查`row`/`column`是否有效，以及`parent`对应的节点是否存在。 2. 在`parent()`中检查`child`节点的`internalPointer`及其父节点指针。 3. 在`rowCount()`中检查`parent`索引对应的节点是否有子节点。	1. 使用`hasIndex()`辅助判断。 2. 确保`createIndex`时传入正确的`internalPointer`。 3. 在树形结构中，`rowCount()`应根据`parent`节点动态返回其子节点数。
编辑后数据没有保存或视图不更新	1.`flags()`方法未返回`Qt::ItemIsEditable`。 2.`setData()`方法未正确修改内部数据。 3.`setData()`方法修改数据后未发射`dataChanged()`信号。	1. 检查`flags()`方法实现。 2. 在`setData()`中设置断点，检查传入的`index`和`value`。 3. 确认`setData()`末尾有`emit dataChanged(index, index, {role});`。	1. 在`flags()`中为可编辑项添加`Qt::ItemIsEditable`。 2. 通过`index.internalPointer()`获取正确数据节点并修改。 3.务必在数据修改后发射信号。
程序崩溃，特别是操作视图时	1.`internalPointer`指向的对象已被删除（悬空指针）。 2. 在`index()`或`parent()`中进行了错误的指针类型转换。	1. 检查模型数据（如`TreeNode`）的创建和销毁逻辑，确保生命周期长于模型和视图。 2. 在指针转换处添加断言或类型检查。	1. 让模型拥有数据的所有权（如在模型析构时`delete rootNode`）。 2. 使用`QPointer`或`std::shared_ptr`管理树节点（需注意`QModelIndex`存储的是裸指针）。 3. 在转换前使用`qobject_cast`（如果继承自`QObject`）或进行有效性判断。
排序、过滤等高级功能无效	使用了`QSortFilterProxyModel`等代理模型，但自定义 Model 未实现必要的接口，如`setData()`或`flags()`。	查看代理模型的文档，确认其需要源模型提供哪些支持。	实现完整的编辑、排序支持接口。对于排序，可能需要实现`sort()`方法。

7. 总结：从理解到掌握

回到最初的面试题：

模型/视图架构和传统 MVC 有什么区别？核心区别在于 Controller 的弱化和 Delegate 的引入。Qt 的 Model 是标准化的、主动通知的数据源；View 是纯粹的表现层；原有的 Controller 职责被分解到 View（接收输入）和 Delegate（处理渲染与编辑）中。这种设计实现了数据与UI的彻底解耦，支持多视图同步。
自定义 Model 必须实现哪些核心方法？它们各自的作用是什么？五个核心方法：
- rowCount()/columnCount()：定义结构。告诉视图数据的形状。
- data()：提供内容。根据索引和角色返回具体数据。
- index()：创建导航句柄。根据位置信息创建QModelIndex，它是视图访问数据的“钥匙”。
- parent()：建立层次关系。对于树形数据，返回子节点的父节点索引，这是构建树形结构的关键。

理解 Qt 的模型/视图框架，不仅仅是记住几个方法和概念。其精髓在于拥抱“数据驱动”的思想：你的应用程序核心是数据（Model），UI（View）只是数据状态的一个实时投影。所有对数据的操作都通过 Model 的接口进行，并由 Model 统一广播状态变化。这种模式极大地提升了代码的清晰度、可测试性和可维护性。

当你下次需要展示复杂数据时，不要急于在QListWidget或QTableWidget里硬编码。停下来想一想，是否可以用QAbstractItemModel构建一个清晰的模型，然后用QListView、QTableView或QTreeView来灵活地展示它。这不仅是应对面试的知识点，更是编写高质量 Qt 应用程序的必备技能。