午后开发手记

午后开发手记

记录编程学习、开发实践,以及值得留下的小想法。

桌灯、笔记本电脑与红色手记本的版画风插画
代码之外,也留一点时间整理思路。配图为生成插画。
开发笔记

把问题缩小到一个可复现的例子

遇到程序行为与预期不一致时,先不急着修改代码。把输入、操作步骤和实际结果写下来,通常比凭印象描述“有时会出错”更有帮助。

先写清楚三个问题

  • 期待得到什么结果?
  • 实际发生了什么?
  • 怎样用最少的步骤再次看到这个差异?

接着逐步去掉与问题无关的页面、数据和依赖。每删掉一部分,都重新运行一次。如果现象消失,刚刚去掉的部分就是值得继续观察的线索。

一份可用的问题记录:输入是什么、操作是什么、期望是什么、实际是什么。

最小示例不一定就是最终修复位置。找到原因后,还要回到完整流程中验证,确认修复没有只照顾到眼前这一种输入。

学习心得

给每一次修改留一条验证记录

“代码改完了”和“问题解决了”是两件事。一次修改结束时,最好留下一条可以再次执行的检查,以及当时看到的结果。

检查应当能指出哪里不对

例如修复一个表单,不仅要看看页面能否打开,还要尝试正常输入、空输入,以及提交失败后的提示。检查的范围跟着修改的影响走,不必为一个小改动搭起复杂的测试系统。

  1. 修改前记录复现步骤和现象。
  2. 修改后使用同样的输入再试一次。
  3. 补一组边界情况,确认错误提示仍然清楚。
  4. 记录哪些已经验证,哪些仍未验证。

如果验证结果只有自己能理解,过一段时间仍然需要重新调查。把过程写得具体一点,是给未来的维护少留一点猜测。

建站手记

从一个简单的静态博客开始

一个个人博客,最重要的是文章能被打开、内容能被读懂。先把文章、配图和页面样式放好,比一开始就准备许多还用不到的功能更实用。

先保留真正需要的东西

清晰的标题、能找到文章的目录、在手机上也能阅读的正文,以及必要的网站信息,已经能组成一个完整的小站。没有评论和注册功能时,也就不需要为了这些功能保存访问者的账号资料。

发布后还需要做几项基本检查:域名是否正确解析,页面和图片能否打开,链接是否指向预期位置,HTTPS 证书是否有效,以及页脚的网站备案信息是否完整。

网站可以慢慢长大。等内容数量真的增加,再考虑分类、独立文章页和搜索;让结构跟着实际需要变化。

关于这个小站

午后开发手记是一个个人博客,整理编程学习笔记、开发实践和学习心得。这里的文章用于交流和记录,不提供交易、会员订阅或在线业务办理。