笔记系统：怎么让记下来的东西找得到
记笔记不难，难的是三个月后还能找到，并且看得懂。这篇写我踩过的坑和现在用的方法。
一、笔记为什么会失效
我观察自己的失效笔记，通常是这几种：
| 问题 | 表现 |
|---|---|
| 抄了一遍文档 | 需要时直接搜官方文档更快 |
| 没有上下文 | 「执行 xxx 就好了」—— 为什么？在哪台机器？ |
| 散落在多处 | 微信收藏、备忘录、桌面 txt、聊天记录 |
| 只记不做 | 记完再没看过 |
| 结构混乱 | 一个文件写十件事，找不到 |
对应的原则：记自己踩过的坑和当时的判断，不记通用知识；每篇一个主题；集中存放。
二、存放：一个地方，纯文本
我的选择是本地 Markdown 文件 + Git。理由：
| 方案 | 优点 | 缺点 |
|---|---|---|
| 云笔记（印象/Notion） | 同步、搜索强 | 数据在别人手里，导出麻烦 |
| 本地 Markdown + Git | 完全可控、可离线、可版本回溯 | 要自己管同步 |
| Obsidian / Logseq | 双链、图谱，体验好 | 有学习成本 |
| 直接写博客 | 有输出压力，质量高 | 私密内容不适合 |
本站的做法：笔记写成 Markdown 文件，挑选可公开的整理成文章发布。私密部分留在本地。
三、目录结构
按「用途」而不是「来源」分类：
notes/
├── 01-运维/
│ ├── nginx-反代配置.md
│ ├── 服务器初始化.md
│ └── 备份脚本.md
├── 02-开发/
│ ├── git-常用操作.md
│ └── 正则速查.md
├── 03-域名/
│ └── dns-排查流程.md
├── 99-临时/ # 未归档的速记
└── README.md # 索引要点：
- 层级不超过两层：超过就找不到了；
- 数字前缀控制排序；
- 有个「临时」区，速记先扔进去，定期整理；
- 文件名用中文 + 短横线，搜索友好。
四、一篇笔记该有什么
我给自己定的最小结构：
# 标题：一句话说清是什么问题
日期：2026-07-06
场景：为什么要做这件事（一句话）
## 结论 / 做法
（能直接抄的命令或步骤）
## 踩过的坑
（这次卡在哪，下次注意什么）
## 参考
（链接）最关键的是「场景」和「坑」：命令可以再搜，但「当时为什么这么选」「哪里会卡住」是搜不到的。
五、标签 vs 双链 vs 目录
| 方式 | 优点 | 缺点 |
|---|---|---|
| 目录 | 直观 | 一篇只能在一个位置 |
| 标签 | 多维归类，灵活 | 标签会爆炸，需要收敛 |
双链 [[...]] | 关联自然，能出图谱 | 维护成本，工具依赖 |
我的做法：目录为主 + 少量标签。
标签使用的教训（本站也踩过）：
# 初版：66 个标签，52 个只出现一次 → 等于没有标签
# 现在：收敛到 27 个，每个至少对应 2 篇标签的价值在于「聚合」，只出现一次的说明该用别的方式归类。
六、检索：让内容能被找到
纯文本的优势是可以随便搜：
# 全文本搜索
rg "certbot" ~/notes
# 按文件名找
fd "nginx" ~/notes
# 看最近改的
fd -t f . ~/notes --changed-within 7d
# 快捷函数（写进 .bashrc）
n() { rg -l "$1" ~/notes | fzf | xargs -r bat; }七、回顾机制（最容易缺的一环）
不回顾的笔记等于没记。我用的方式：
| 频率 | 做什么 |
|---|---|
| 每次用后 | 遇到新问题立刻补进原笔记 |
| 每周 | 清空「临时」区，归档或删除 |
| 每月 | 翻一遍目录，删掉过时的 |
| 每季度 | 挑有价值的整理成可发布的文章 |
「整理成文章」这步特别有效：
- 逼你把散乱的速记组织成有逻辑的结构；
- 会发现自己的理解漏洞；
- 产出可以公开的东西，有正反馈。
本站 100 篇笔记，大部分都是从本地速记整理来的。
八、备份
笔记比服务器更值得备份——服务器可以重建，笔记不能。
# Git + 远端私有仓库
cd ~/notes
git init && git add . && git commit -m "init"
git remote add origin git@github.com:you/notes.git
git push -u origin main
# 每天自动提交（简单粗暴但有效）
0 23 * * * cd ~/notes && git add -A && git commit -m "auto $(date +\%F)" && git push用私有仓库。笔记里可能有内网地址、临时密码。
九、工具推荐
| 需求 | 工具 |
|---|---|
| 编辑 | Vim / VS Code / Obsidian |
| 搜索 | ripgrep + fzf |
| 同步 | Git / Syncthing |
| 绘图 | Excalidraw / Mermaid |
| 剪藏 | 直接复制关键片段，附原文链接 |
十、几条我坚持的原则
- 只记自己做过的事（不抄文档）；
- 每篇只讲一件事（好找、好引用）；
- 写下当时的判断（比命令更有价值）；
- 能搜到就不记（记搜索关键词就够）；
- 定期整理（否则会变成垃圾场）；
- 输出（把笔记变成文章，检验理解）。
笔记系统的目的不是「记得多」，而是下次遇到同样问题时，能比第一次快十倍。