淡墨19131. 项目概述与设计背景
在开发多文档编辑器这类应用时，文件列表侧栏的设计往往成为架构难点。传统做法是将所有逻辑堆砌在主窗口类中，导致代码臃肿、维护困难。这个Qt导航栏组件（A05系列）通过三层架构设计，实现了职责清晰分离的可复用解决方案。
核心痛点在于：文件列表项不仅是简单的导航入口，还需要处理以下复杂交互：
- 实时反映文件修改状态（未保存标记）
- 悬停显示操作按钮（关闭功能）
- 处理文件关闭前的保存确认
- 避免重复打开同一文件
我在实际项目中多次遇到这类需求，发现将UI状态管理、数据逻辑和业务处理混在一起会导致：
- 主窗口代码超过3000行难以维护
- 样式调整需要修改多处分散的代码
- 交互逻辑变更影响范围不可控
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 整体架构设计
2.1 三层组件结构
本方案采用分层设计，各层职责明确：
| 组件层级 | 职责范围 | 对应类 |
|---|---|---|
| 业务逻辑层 | 文件读写、对话框交互 | MainWindow |
| 数据管理与列表协调层 | 维护打开文件列表、处理项间关系 | FileListWidget |
| 视觉表现层 | 单项UI状态、交互反馈 | FileListItemWidget |
2.2 核心交互流程
典型用户操作的数据流向示例：
- 用户双击打开文件
- MainWindow接收操作，创建/获取文件内容
- FileListWidget添加新项或切换现有项
- FileListItemWidget更新视觉状态
- 用户编辑内容后，通过信号通知各级组件更新状态
关键设计原则：下层组件不直接调用上层方法，全部通过信号槽通信
3. 核心实现细节
3.1 文件项组件(FileListItemWidget)
这是最具技术含量的部分，需要处理多种视觉状态：
cpp复制c