技术笔记的复习机制：怎么让写过的不白写
义眼流光
3 min read
写好技术笔记不难，难的是三个月后它还对你有用。不少人积累了上千条收藏和几十篇笔记，遇到同类问题却还是重新搜一遍。不复习的笔记只是把信息从屏幕搬到了硬盘，所有权归了文件夹，知识没进脑子。
笔记会过期，人也会忘
我见过一种状态：某人半年前踩过一个时区 bug，写得非常详细，半年后团队另一个人踩了同样的坑，他翻了十分钟没找到自己那篇，又调了两小时。问题不在记，在于记完就封存。人的记忆曲线决定了，不主动复习的内容大约一周后就模糊，一个月后基本只剩"我好像写过"的错觉。
一个能跑通的复习节奏
不靠意志力，靠固定动作。建议每周五下午留二十分钟，只做两件事：
- 快速扫一遍本周新笔记的标题，标记哪几条值得回看；
- 打开一条旧笔记重读，如果已经看不懂或已过时，当场改或删。
工具层面，给每条笔记打两个标签就够：问题类型（如"并发""部署"）和解决状态（"已验证""待确认"）。复习时优先看"待确认"，这些最容易悄悄过时。
让笔记可被检索，而非可被收藏
收藏是动作，检索才是目的。经验上，笔记标题要比内容更"像你会搜的词"。比如不要写"关于缓存的一次排查"，而写"缓存击穿导致接口超时排查"。前者文艺，后者是你半夜出事时会敲进搜索框的原话。
另外，把结论前置。一条笔记最上面三行应该是：现象、根因、解法。细节往下放。复习时扫三行就能决定是否要深读，省下的时间会让你更愿意复习。
反例与判断标准
反例是把笔记当仓库：分类越来越细，文件夹套五层，结果从来打不开第三层。判断你的笔记系统有没有用，看一条标准——上次遇到新问题，你是从自己的笔记里找到答案，还是又从头搜了一遍？如果是后者，系统就该精简，而不是扩张。
一个具体的复习样例
假设本周你记了一条"Kafka 消费积压排查"。周五复习时，把当时漏掉的一点补上：原来消费组重平衡也会造成短暂积压，这点和真正的下游慢要区分开。顺手在标签里从"待确认"改成"已验证"。
这条补丁，往往比原文更有用，因为它来自你自己的二次理解，而不是第一次记录时的匆忙。经验上，复习时顺手补一个细节，比重新写一篇新笔记更能让旧知识活过来。每月挑一条旧笔记做一次这种"回炉"，半年后你会拥有一批真正属于你的结论，而不是一堆待消化的原材料。
1 view
0 likes
0 comments