示例条目：一次调试笔记

问题

一段能复现问题的描述，以及它在什么条件下才出现。把条件写清楚，是这条笔记最值钱的部分 —— 结论会过时，条件不会。

排查路径

按时间顺序记下试过什么、各自排除了哪种可能。走错的路也要写：下次最可能重走的就是它们。

func main() {
	println("最小复现")
}

最后定位到的那一处

结论应当能反过来解释"为什么只在那个条件下出现"。若解释不通，说明还没找到根因，只是找到了一个能让它不出现的位置。

SELECT id, status
FROM media_objects
WHERE status = ?
ORDER BY id DESC;

几个容易混的点

现象	常见误判	实际原因
偶发失败	并发问题	依赖了未初始化的值
本地不复现	环境差异	数据量不同，走的分支不同

未标语言的代码块走纯文本词法器。
它同样会做转义，因此这里的 <尖括号> 是安全的。

结论

一句话能说清的结论，加上「下次遇到先查哪里」的一句话。