如何写好技术笔记

技术学习过程中，记笔记是一个被低估的习惯。好的笔记不仅能帮助复习，还能在后续遇到类似问题时快速定位思路。

为什么要写笔记

• 对抗遗忘：很多细节只看一遍是记不住的。
• 梳理逻辑：写下来的过程，也是强迫自己想清楚的过程。
• 积累资产：长期积累下来，笔记会成为个人知识库的一部分。

笔记的三个层次

1. 记录问题

最基础的笔记是记录「我遇到了什么问题，怎么解决的」。例如：

Nginx 配置修改后域名无法访问，原因是 server_name 没有包含裸域 zsdn.top。

这种笔记最实用，但价值只限于解决当前问题。

2. 提炼原理

在解决问题之后，进一步思考「为什么」。例如：

Nginx 根据 HTTP 请求头里的 Host 字段匹配 server_name，如果匹配不到就会落到默认站点或返回错误。

理解原理后，再遇到类似问题就能举一反三。

3. 形成范式

最高级的笔记是提炼出可复用的方法论。例如：

域名访问排查 checklist：DNS → 安全组 → Nginx server_name → 站点根目录 → 错误日志。

范式化的知识更容易迁移到新场景。

我的笔记习惯

• 用自己的话重写：不要复制粘贴文档，强迫自己理解后表达。
• 保留上下文：记录当时的系统环境、版本号、报错信息。
• 定期回顾：每个月翻一遍近期笔记，补充遗漏或纠正错误。
• 公开分享：把经过整理的内容写成博客，既能帮助他人，也能加深自己的理解。

写在最后

笔记不是为了写而写，而是为了让自己以后能更快地找到答案。从今天开始，尝试把每一个踩过的坑都变成一篇可检索的笔记吧。