只记录真实卡点。卡住超过 15 分钟、验收题答错、Demo 跑不通、项目设计返工,都写到这里。
| # | 日期 | 章节/项目 | 现象 | 根本原因 | 正确做法 | 复盘日期 |
|---|---|---|---|---|---|---|
| 1 |
- 当天记录:先写现象和临时解决办法,不追求完整。
- 复盘补齐:第二天补“根本原因”和“正确做法”。
- 复习关联:如果错误来自某章验收题,在
review-plan.md的备注里标记。 - 项目关联:如果错误来自
projects/,在项目 README 的“踩坑记录”里同步一句。
- 变量作用域、可变默认参数、字符串/列表/字典方法混用。
- 列表、元组、字典、集合的适用场景判断错误。
- 入口文件、业务逻辑、配置、测试混在一起,导致无法复用。
- 没有激活虚拟环境、依赖未锁定、不同项目共用全局包。
- 状态码、错误响应、分页、认证、数据库会话边界处理不清。
- 只测正常路径,没有覆盖空输入、重复数据、非法类型和异常路径。