一份好用的技术笔记，应该留下什么？

技术笔记的价值，是让下一次遇到相同问题时，可以快速理解背景、复现过程并验证结果。比起只保存最后一行命令，留下推理的路径往往更有用。

先记录现象和环境

写清楚“想得到什么”和“实际发生了什么”。附上必要的软件版本、部署方式与错误信息。分享日志之前，移除密码、令牌和个人数据。

把原因与证据放在一起

区分已经确认的事实和仍在验证的假设。例如，服务进程存在不等于端口已监听；本地访问成功也不等于公网访问成功。每一个结论最好都能对应到一条可复查的证据。

给出可执行的步骤与验证方法

说明操作所在的环境、执行顺序与预期输出。配置修改应当先备份、检查语法，再加载。最后列出如何确认问题已经解决，以及需要恢复时使用哪份备份。

用视频补充难以描述的操作

涉及界面交互或连续操作时，一段短录屏可以补足文字。给视频配上步骤摘要和关键时间点，也方便读者在不播放完整视频的情况下找到答案。