Windows下QFileSystemModel::setRootPath行为与文档不符问题

问题背景 #

Qt官方文档对QFileSystemModel::setRootPath()的说明是：

通过在newPath上安装文件系统监视器，将模型监视的目录设置为newPath。该目录内文件和目录的任何更改都会反映在模型中

但当执行以下代码时：

auto model = new QFileSystemModel;
model->setRootPath("C:\\folder");
treeView->setModel(model);

实际运行中模型不仅会跟踪C:\folder下的更改，还会监控该路径之外甚至其他磁盘的内容变化，与文档描述不符。

核心疑问 #

• 为何实际监控范围超出了setRootPath()指定的路径？
• 如何正确理解setRootPath()的工作机制？
• 若QFileSystemModel会自动监控视图中所有可见路径，该方法指定监控路径的意义何在？

机制解析 #

• setRootPath()的真实作用：它并非用来限制模型的监控范围，而是设置模型的「根索引」，供QTreeView这类视图确定初始展示的起始节点。同时，它会为指定路径预先挂载文件系统监视器，但QFileSystemModel本身的设计是按需监控——当用户在视图中展开某个目录节点时，模型会自动为该目录添加监视器，确保展开后的内容能实时更新。
• 文档描述的局限性：文档仅强调了主动设置路径的监控行为，未提及模型内置的按需监控逻辑，容易造成误解。QFileSystemModel本质是一个可访问整个文件系统的模型，setRootPath()只是设置视图的起始展示位置，而非限制模型的访问和监控边界。
• 指定监控路径的意义：
  1. 为视图提供默认根节点，明确初始展示的起始路径；
  2. 预先监控指定路径，确保该路径下的内容在视图初始化阶段就能实时响应变化；
  3. 模型内部会基于该路径初始化文件系统相关的缓存与状态，提升后续访问效率。

结论 #

当你在QTreeView中展开C:\folder之外的节点（比如上级目录C:\或其他磁盘分区），模型会自动为这些新展开的目录添加监视器，因此会出现监控范围超出指定路径的情况。这是模型的设计特性，目的是保证用户浏览到文件系统任意位置时，视图内容都能实时同步更新，并非功能bug。

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