一、轻文档先行
1. 为什么要写文档
刚开始工作的时候,总是一接到任务就马上开始写代码,结果遇到了很多问题,例如:
①. 需求本身就存在问题,代码写到一半以后才发现
②. 部分需求没有表达清楚,发现的时候才去沟通,结果发现时间不够,或者跟之前的代码产生冲突
③. 代码写到一半时,发现自己思路不对或者不清晰了
最后很有可能导致项目延期。时间紧 测试不完整,
如果在开发前就把需求分解好,把问题沟通清楚,把要做的点一个个列下来,就能大大地避免这些问题。
2. 文档写什么
①. 准备工作
在开始之前需要准备什么?例如做一个发送消息的界面,需要有以下的准备:
a. 接口协议
b. 测试环境
c. 测试账号
d. 测试数据
准备工作提前做好,往往会加快效率。为什么要把这些内容记录下来,是为了在开发过程中可以快速检索。如果等到开始开发以后再去查聊天记录,或者是找相关人员询问,那就慢了。
②. 罗列需要做的小功能点
例如做一个发送消息的界面,就有很多小功能点:
a. 发送界面
b. 发送的数据接口
c. 文本字数限制
如果你仔细一想,可能还会出现以下问题:
a. 是否需要登录?如果未登录,是否要引导登录
b. 对于发送失败的情况,要如何处理?
c. 字数超出限制时,如何交互?
d. 用户重复发相同的文本,是否要过滤?
e. 如何处理数据接口的错误码?
当你记录下这些小功能,并且跟产品经理沟通清楚以后,你的开发周期已经可以初步评估了,并且这时候也已经弄清楚这个需求有多少小功能,需要怎么划分模块,怎么构建内部流程。
对于部分流程复杂的功能,可以画一下流程图辅助理解
③. 记录这个需求的改动点
如果这是一个新需求,并且跟以前的版本没有任何关系,则可以忽略这部分
如果是这个需求会影响以前的代码,则需要将改动部分记录下来,因为项目中的 bug 有很多是改出来的,列出改动点后会让自己更清楚新功能带来的影响,减少很多低级bug
例如新增一个发送图片的功能,这个功能会影响聊天窗口的展示,会影响键盘,这些改动点就要记录下来。一来可以辅助思考有没有漏掉的小功能点,二来在自测试的时候需要覆盖聊天窗口的展示和键盘的切换。
二、开始编码
1. 是重写还是保持不变
每做一个新需求,都有可能会面临这样的问题:
①. 以前的模块写得太烂了,很想重新写
②. 差不多的需求,以前用了这样的方式实现,这次想换一种方式实现
会考虑以上的问题,证明你是一个想要不断进步的人,但是,在做决定之前最好先考虑以下因素:
①. 重写模块,很可能牵一发而动全身,要想清楚改动可能带来的影响,以及解决这些问题需要的时间
②. 使用新方案实现需求,新的方案是否已经经过仔细的验证,如果没有,它可能会带来新问题
其实保持不变也有一些优势:
①. 可以比之前做得更快,因为你熟悉了
②. 不会出现新问题
考虑好以后,是重写还是保持现状,基本已经有答案了
不过保持现状并不意味着是放弃追求,你可以用业余的时间来证明你的方案,当它已经稳定了,可行了,那你随时都可以重写了。
2. 实现需求,Demo 先行 — 没有做过的项目
用 Demo 来实现一个需求是最快的,因为它运行快,可以随意修改,而且代码量少,如果实现过程出现问题,很容易就可以定位到原因。
先建立一个 Demo,然后把需要的资源移植过来,把功能实现以后,再移植到项目中,这样可以节省不少开发时间
④. 罗列自测试内容
编码完成以后,一定要进行自测试,自测试越仔细,越能提前发现 bug 并修复。如果是测试人员发现了 bug ,然后再提交给你,你这时候再去解决,效率往往会比较低。
以发送消息为例,自测内容也有很多:
a. 正常发送消息
b. 未登录时点击发送
c. 字数超出限制
d. 没有网络时点发送
e. 网络很差时不断点发送
等等…….
三、自测
1. 先检查后自测
完成一个小功能以后,先检查一下代码,然后再开始自测,因为代码可以告诉你很多信息:
①. 是否有低级错误
②. 是否有难以发现的漏洞
③. 流程是否存在问题
如果你编码完成以后立即自测,可能会进入被动状态:
①. 这个界面显示不对
②. 这个数据跟预期对不上
③. 有些不该出现的东西出现了
这时候再反过来去调试代码,一步步修改,会很慢,因为你编译和操作都需要时间,而且有些条件不是很容易模拟,那种情况就更耗时间了
2. 自测点要全部过一遍
可能你会觉得这很烦,很浪费程序员的时间,但自测过程发现 bug 是最容易修复的,因为这时候代码记忆最清晰,最容易找到问题所在。
四、总结
先用文档理清思路,然后开始编码,编码完成以后要检查代码并自测。这就是我的编程习惯,一直沿用至今。
其实知道一个技巧,并不会提升效率,只有坚持使用这个技巧,并形成习惯以后,才会真正地提高效率。