设计方案,写了才知道有多香

Posted 「零一」

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了设计方案,写了才知道有多香相关的知识,希望对你有一定的参考价值。

大家好,我是零一,今天要跟大家聊聊开发流程中不起眼的环节——设计方案。你们可能没听过,也可能只是简单得走过过场,别划走,这非常重要!

在字节,我接触到了更完善、更规范、更高效的开发流程:产品需求设计 => 需求粗评 => 做设计方案 => 粗估时 => 需求细评 => 排期 => 开发 => 提测、修bug => code review => 上线

其实在我未工作之前,大部分的流程我都听说过或者在实习时经历过,比较少接触的可能就是设计方案code review了,这两者分别是干什么的?

  • 设计方案:在拿到需求后,写一个文档,来描述自己对于该需求的实现思路、模块划分等相关考虑的点,可供今后自己或他人查阅
  • Code review:代码提交合并前给mentor或leader检查一下你的代码,让别人作为旁观者来看你的代码,集思广益,完善代码,发现未考虑到的边界问题

说实话哈,啥设计方案啊,我第一次在一家小公司实习的时候,突然就被产品叫过去,花5分钟给我阐述了一下下个版本他想要上的功能,紧接着立马就问我:你看看大概需要多久?我的预估是5天后就上线,ok吗?

我:????????? (内心os:我刚知道这个需求,我哪能那么快知道我得花多久做出来啊!你说5天就5天吧,反正我说6天也没用)

太离谱了,可能很多小公司的现状都是像我说的这样吧!这样真的很不好,版本快速迭代中掺杂着许多需求,而开发时间又比较紧张,只会让开发想尽办法怎么赶紧把功能实现,而不会去考虑任何性能问题,更别说让你考虑边界问题了。长期这样下去,你会深深地体会到你处于一个无止境的项目快速迭代中,加班、通宵可能都是常事,哪还会有时间去学习新的知识或做自己爱做的事,也不会有多余的时间去关注自己接手的需求从开发到上线的整个生命周期线,不会定期去复盘,因此个人的项目经验、技术积累是很少的

之前也有小伙伴私聊过我类似的情况,我也是建议他最好能在一个有「自我学习」、「定期复盘反省」的环境中工作

大圣老师就是如此,记得他在有次直播中讲到,他当年去360时,把「能留给自己充足的学习时间」作为他最在乎的因素,这样真的非常好。大家也可以看看自己当前的现状是否真的利于自己发展,然后做更长远的打算。

好了,言归正传!

我们为什么要写设计方案呢?

目的是为了在真正开始敲代码之前理清自己的思路,对需求有一个更清楚的认识,这样就不至于在开始开发后边写代码边思考了,想必你们都有遇到在写代码时突然发现哪一模块之前没考虑到,然后对之前写好的代码的架构进行调整,代码进行抽离,这无疑是在降低开发效率。

另一点就是时间一久,突然这个功能出现了一个bug让你去修复,你可能会对自己写的代码有些忘却,此时找到之前自己写的设计方案一看便知,这同样也能作为新入职的小伙伴在熟悉现有代码的重要资源!

对于第二点我深有感触,到一个新部门总会接手1~2个祖传项目代码,紧接着你就要阅读他们的代码逻辑,这是非常痛苦的,因为你根本不了解这些需求的背景,也不了解他人代码完整的设计思路,这不跟抱着一本厚书在那硬啃一样嘛!

image-20210725102004643

要是之前的人都写过设计方案,你完全可以在看每个模块的时候,找到相应的文档,这不事半功倍嘛~

那么如何写设计方案呢?

整个方案大致分为4个部分:需求相关信息方案调研具体方案其它

一、需求相关信息

作为一个开发工程师,一定要有工程师的精神,需要对自己所接手的需求有清晰的认识,这包括:负责这个需求的其它相关人员分别是谁(产品、测试、UI、后端等)、我这个需求的出现背景是什么、需求何时提测,何时上线…

格式如下:

一、需求相关信息

 需求背景:因为我们要做线下推广,提高xxxxxxxxx
 PRD:文档链接
 产品:小华
 UI:小明
 测试:小红
 前端:零一
 服务端:小张
 联调时间:2021.07.30
 提测时间:2021.07.31
 上线时间:2021.08.10

把这些内容写在设计方案的开头,让跟这个需求相关、不相关的人都能一目了然,如果遇到问题也可以立马精准地找到相应的人

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-gcgYAzSJ-1629268348043)(https://mmbiz.qpic.cn/mmbiz_png/lgHVurTfTcyTg1OlvoiaicMNktCUib3myEEhWqA50Z9JDhkcTmiaOticKgHweWq36zOcW1Ww79Z3J56jvMtsMlSmB4g/640?wx_fmt=png&wxfrom=5&wx_lazy=1&wx_co=1)]

二、方案调研

这一部分主要是需要我们在考虑功能实现的技术选型时,对比很多不同的方案,综合考虑每一种方案的优缺点,可以适当地取舍和改进,形成一套适合当前场景的技术方案。

举个比较简单的例子吧,假设你此次接的需求中有一个复杂的动画要实现,那么你以下这几种考虑的方向

  • 以前我有没有做过类似的动画,可以借鉴的?
  • 公司内部有没有什么现成的库或者代码能用?
  • 业界有没有现成的库或者比较不错的实现思路?
  • 如果不用别的库,用原生实现,我会怎么做?有没有什么兼容性等其它问题?

在了解了这四种场景以后,我们此时需要思考别人的方案和我自己的方案哪一个更好,优缺点分别是什么?别人的方案是否适用于我们当前的场景?在综合考虑了众多因素后,我们选择一套相对比较靠谱的方案用于实行。

通过以上几个步骤来支撑我们接下来敲出来的代码的可靠性与质量!

三、具体方案

这部分是最重要的了,它几乎涵盖了你所有需要思考的东西:业务的完整流程数据结构的设计关键功能的逻辑描述异常的处理安全性性能与现有业务的耦合情况组件复用

起码要保证其他人以及你自己,在看到具体的方案介绍时,可以很清楚地明白你的设计思路、写代码的思路、模块的划分。你可以用任何形式去表达你的思路,例如伪代码、流程图或者纯文字等等

简单演示一下:

「流程图」

流程图的设计能让你对自己的需求有更清楚的了解,也能让他人对这个需求有一个直观的认识

「伪代码」

function getSomeData() {
  let data; 
 if(无缓存) {
    // 请求数据
    if(请求异常) // 展示错误页面;
    data = 请求到的数据;
  }
  
  // 展示页面
}

伪代码可以在你不写具体代码实现前,展示大致的编码思路,那么在大家一起过你的设计方案时,就可以很清楚得知道你的代码想怎么实现,因为是伪代码,所以非技术的同学说不定也能看懂,然后给你提点意见呢!

「模块划分」

模块的划分也是考验你架构设计的一个点,你需要考虑清楚你的代码中,哪些需要单独抽离出来作为一个单独的模块,哪些可以作为公共组件,哪些是跟业务高耦合的

「用例图」

用例图的话,能帮助你整理需求中每一个大大小小的场景,这个光靠脑子想可能没有太大的作用,当你列出来时,你可能会发现这个流程好像少了点什么东西,也就是有助于你考虑更全,关注到一些犄角旮旯的边界。插播个小彩蛋,我有个前端同事写用例写的特别好,有一次leader调侃说他这个写的也太太太详细了,每一处考虑得都特别周全,甚至都可以直接原封不动得给测试当测试用例了,hhhh

我所列举的例子都比较简单,大家根据自己实际情况进行操作就好。

还有一些别的就是,你还需要考虑一下你的某些接口需不需要考虑安全问题,比如点击submit会增加抽奖次数,那不会被别人恶意伪造一些信息进行刷抽奖次数呢?还有你的页面会不会存在一些性能问题?如果以后要在这个需求上扩展别的功能,你觉得你的代码可扩展性如何?当然,你要考虑的肯定远不止这些,希望每个工程师都能对自己的方案考虑周全,做到精益求精,这样才是一个合格的工程师!

四、其它

最后一部分完全可以留给你自己自由发挥,可以记录下与这个需求相关的一切,我个人觉得可以写的有这些:

  • 你在写设计方案时遇到的问题以及解决办法
  • 你的代码上线以后,用户的反馈如何,如果好,好在哪里;如果不好,到底是哪里出了问题,该如何解决
  • 你在方案调研时,有没有发现别人的方案哪里做的不好,或者有哪些值得学习的地方
  • 在此次整个开发流程中,有觉得哪个流程不太好的(低效、无用的沟通等等),可以记录在此,然后找相关人员讨论改进
  • more…

总之,这里随心所欲发挥

实践感受

一开始让我写设计方案时我略微有些抗拒,就心里想着为啥写个代码还要先写文档,这不是在增加我的工作量嘛?

后来leader告诉我,写设计方案的时间不会算在我的开发时间内的,而是在开发时间之前,给我3~4天专门用来写设计方案(内心os:woc?这么爽!我写!我写!),这不香的要死嘛,于是我也就开始尝试写设计方案了

在写的过程中发现,流程上我可能会发现一些同事们都没有考虑到的问题,这是站在开发的视角去看的,所以产品同学难免会遗漏一些点;而在case的梳理上我又偶尔会发现大家都没有考虑到的边界问题,可能是真的大家都没考虑到,也有可能是我的想法比较独特,但这都ok,在后面所有相关人员统一过我的设计方案的时候可以一起讨论出个对错。嗯,这些都是光凭脑袋想不一定能想到的,或者哪个瞬间想到了却来不及记录,到了开发的时候又给忘了!

等我设计方案写完以后,相关人员会约一个时间一起听我讲一遍我的设计方案,不同岗位的同学有不同的视角去看问题,每个人也有不同的想法,所以这里能暴露出很多问题,也能把很多不ok的点处理掉,例如我的leader经验比较丰富,每次过设计方案时他都会提醒我哪一块儿地方可能会存在安全问题,记得考虑一下。

再后来测试同学会整理一些测试用例,拉大家case评审,你之前做过了设计方案,对自己的需求非常熟悉了,那么在测试过你的需求的case时你会更加的明白,也许测试考虑到了你没考虑到的点,也许是他遗漏了某些点而你考虑到了,这些都是可以互补的。

完成了以上内容,基本上我写代码的思路就通了,确实也节省了不少的时间!等我开发完以后,还会再自测一遍,怎么测?直接拿我设计方案和测试给出来的测试用例对照着自测就好啦,总不能说你自己这里都还没跑通就拿过去给测试测吧?

总之收获还是很大,但设计方案的实施还是需要有一个不那么短的开发周期的,那种需求刚提,5天上线的情况哪有时间给你写设计方案啊,就更别说考虑这么多东西了,你自己个人也很难沉淀下东西

不过哦~我突然又发现了写设计方案的另外一个隐藏好处!我们的简历上不是会写上自己过往项目经验和工作经历嘛,这些都跟我们做过的项目需求紧密相关,你如果之前每个需求都写设计方案,那么写简历还用愁嘛,妥妥的筛选一下 + 复制粘贴啊

我是零一,希望本文对你们有所帮助,对于设计方案的看法,你们可以在评论区发表~ 也欢迎访问我的个人博客

以上是关于设计方案,写了才知道有多香的主要内容,如果未能解决你的问题,请参考以下文章

设计方案,写了才知道有多香

设计模式3.2-- JDK动态代理源码分析有多香?

Github上堪称最全的面试题库(Java岗)到底有多香

如何更改谷歌地图标记上方的标题和片段设计

提效小技巧——记录那些不常用的代码片段

有人知道下面的代码片段是啥意思吗?