# Bug修复: {{BUG_DESCRIPTION}}

**日期**: {{DATE}}
**修复者**: {{AUTHOR}}
**相关Issue**: #{{ISSUE_NUMBER}}（如有）
**Git Commit**: {{COMMIT_HASH}}

---

## Bug描述

{{详细描述bug的表现，包括错误信息、异常行为等}}

## 复现步骤

1. {{步骤1}}
2. {{步骤2}}
3. {{步骤3}}
4. **观察到的错误行为**: {{描述错误}}

## 根本原因

{{分析bug的根本原因，包括代码逻辑问题、边界条件、数据异常等}}

### 问题代码位置
- 文件: `{{FILE_PATH}}`
- 行号: {{LINE_NUMBER}}
- 函数/类: `{{FUNCTION_NAME}}`

## 修复方案

{{描述如何修复这个bug，包括修改的逻辑、算法改进等}}

### 修改前代码
```cpp
{{原始代码片段}}
```

### 修改后代码
```cpp
{{修复后的代码片段}}
```

## 修改文件清单

- `{{FILE_1}}` - {{修改说明1}}
- `{{FILE_2}}` - {{修改说明2}}
- `{{FILE_3}}` - {{修改说明3}}

## 测试验证

### 测试场景
{{描述测试场景和测试数据}}

### 测试步骤
1. {{测试步骤1}}
2. {{测试步骤2}}
3. {{测试步骤3}}

### 测试结果
- ✅ {{成功的测试案例}}
- ✅ {{成功的测试案例}}

### 性能影响
{{描述修复对性能的影响，如有}}

## Git提交信息

```
Commit ID: {{COMMIT_HASH}}
Commit Message: {{COMMIT_MESSAGE}}
Branch: {{BRANCH_NAME}}
```

## 相关文档

- [{{相关文档1}}]({{LINK1}})
- [{{相关文档2}}]({{LINK2}})

## 备注

{{其他需要说明的内容、注意事项、后续改进计划等}}

---

**归档位置**: `archives/bug_fixes/{{DATE}}_{{BUG_NAME}}/`
**文档副本**: `docs/fixes/`