把解题过程写成可复用的方法

技术笔记最常见的问题，是只留下最后那条“有效命令”。它能解决眼前的问题，却无法解释为什么有效，也很难迁移到下一次故障。

从问题开始

先用一句话描述实际现象，而不是提前写入自己的判断。例如：

服务进程存在，但通过公网域名访问超时；本机访问 127.0.0.1:3000 正常。

这句话包含可观察的事实，也自然缩小了检查范围。

分开记录假设和证据

一个简单模板就够用：

项目	内容
现象	用户实际看到什么
假设	目前认为可能的原因
验证	使用了什么命令或实验
结果	哪些事实支持或否定假设
结论	根因与最终处理方式

关键是不要把“我认为”写成“事实”。假设可以错，记录它被排除的过程仍然有价值。

保留环境和边界

命令是否有效，往往取决于操作系统、版本、权限和网络位置。至少要写清：

• 操作系统与关键软件版本；
• 命令在哪台机器、以什么用户执行；
• 配置修改的作用范围；
• 是否需要重启，以及如何回滚。

在最后提炼检查顺序

一次问题解决后，把过程压缩成下次可以直接执行的检查顺序。例如 Web 服务连接失败时，可以从进程、监听端口、本机访问、防火墙、反向代理、DNS 逐层验证。

好的笔记不仅保存答案，也在训练判断顺序。