Codex
59 lines
2.4 KiB
Markdown
59 lines
2.4 KiB
Markdown
# Fix-BUG-20260217-0001
|
||
|
||
> 适用场景：记录某个 BUG 的修复方案、影响评估、验证结果与落地信息。
|
||
|
||
## 关联信息
|
||
|
||
- Fix ID: Fix-BUG-20260217-0001
|
||
- 关联 BUG ID: BUG-20260217-0001
|
||
- 修复目标: `TabControl::getActiveIndex()` 在页签列表为空或无页签激活时返回 `-1`，有页签激活时返回对应索引。
|
||
- 状态：已完成
|
||
- 负责人: 未记录
|
||
- 分支 / 版本: master / v3.0.1
|
||
|
||
## 根因分析
|
||
|
||
- 根因: `getActiveIndex()` 未处理“页签列表不为空但所有页签都未激活”的情况。
|
||
- 触发条件: 调用 `TabControl::getActiveIndex()` 时，页签列表非空且没有任何激活页签。
|
||
- 为什么之前没发现：[可选] 测试缺失，未覆盖无激活页但列表非空的返回值场景。
|
||
- 关键证据：[可选] 代码分析确认旧逻辑会返回最后一个页签索引。
|
||
|
||
## 修复方案
|
||
|
||
- 修复思路: 增加无激活页兜底逻辑；页签列表为空或遍历后未找到激活页时统一返回 `-1`。
|
||
- 关键改动:
|
||
- 修改 `TabControl::getActiveIndex()`，在无激活页时返回 `-1`。
|
||
- 涉及文件 / 类 / 函数:
|
||
- `TabControl.cpp`
|
||
- `TabControl::getActiveIndex()`
|
||
- 影响的 API / 行为：[可选] 修正返回值语义；调用方可可靠用 `-1` 判断无激活页。
|
||
- 关键约束 / 不变量：[可选] 无激活页必须返回 `-1`，不能返回任意有效索引。
|
||
- 回滚点 / 开关：[可选] 回退无激活页兜底返回逻辑。
|
||
|
||
## 影响评估
|
||
|
||
- 影响范围: TabControl 激活页查询、依赖 `getActiveIndex()` 的业务判断。
|
||
- 兼容性影响：无（修复 BUG）
|
||
- 行为变化：有（无激活页从错误有效索引变为 `-1`）
|
||
- 性能影响：无明显影响。
|
||
- 回归风险: 低；需确认有激活页和空列表场景返回值正确。
|
||
|
||
## 验证结果
|
||
|
||
- 验证步骤:
|
||
|
||
1. 调用 `TabControl::getActiveIndex()`，验证页签列表为空时返回 `-1`。
|
||
2. 验证页签列表不为空且所有页签未激活时返回 `-1`。
|
||
3. 验证存在激活页时返回对应索引。
|
||
|
||
- 验证结果: PDF 历史记录标记已修复。
|
||
- 回归检查：[可选] TabControl 默认激活、页签切换、无激活页状态。
|
||
- 验证证据：[可选] 无
|
||
|
||
## 落地信息
|
||
|
||
- Commit: b765e54eff28ebcd0bd99a81dec80b3ac0769337
|
||
- PR：[可选] git
|
||
- 发布版本: v3.0.1
|
||
- 备注: 来源原始 Fix 记录未包含 `-XXXX` 后缀，入库时按 BUG ID 补充为 `Fix-BUG-20260217-0001`。
|