把学习笔记写成以后还能用的东西
458 字
2 分钟
把学习笔记写成以后还能用的东西
写下一段笔记很容易,过一段时间还能看懂并用上,却需要多想一步。对我来说,一篇有用的技术笔记,可以围绕问题、过程、结果和验证来组织。
先写清楚遇到了什么
与其只写“安装失败”,不如记录执行了哪条命令、在哪个目录运行、终端出现了什么提示。问题描述越具体,下次检索时就越容易找到。
不需要保存整屏日志,留下能说明情况的关键几行就好。
把操作和原因放在一起
一条命令只能告诉未来的自己“做过什么”。在旁边补一句为什么这样做,才能留下可复用的判断。
例如,修改图片路径时,除了记录新路径,还可以说明图片实际放在哪里、网页为什么不需要包含 public 这一层目录。
留下验证的方法
执行成功不是唯一的判断标准。图片是否真的显示?链接是否打开了正确的页面?本地预览和正式构建是否一致?
把验证过程也写下来,就能在环境变化之后重新检查,而不是只凭记忆猜测。
一个可以反复使用的提纲
- 问题: 我想完成什么,实际发生了什么?
- 环境: 涉及哪些工具、文件和版本?
- 处理: 哪些操作解决了问题,为什么?
- 验证: 用什么方式确认结果?
- 补充: 哪些尝试没有效果,哪些地方以后还可以改进?
笔记不必一次写得很长。先留下一个准确的小结,再在真正需要的时候补充,往往比追求一开始就面面俱到更容易坚持。
文章分享
如果这篇文章对你有帮助,欢迎分享给更多人!
把学习笔记写成以后还能用的东西
https://alice901.xyz/posts/useful-learning-notes/
