关于程序员:团队协作中如何写出让同事赞不绝口的代码

6次阅读

共计 1872 个字符,预计需要花费 5 分钟才能阅读完成。

团队中的每个人都会用不同的视角来’扫视‘你的”作品“,那么咱们如何拿出一份像艺术品一样的我的项目代码,而后博得得共事们的称许呢?

作者 / 琼虎(安增平)

编辑 / hjy

00 前言

在退出了领有较高技术底蕴的有道精品课团队后,发现自己在后面的职业生涯中养成的一些‘作坊’习惯必须失去纠正。

在日常工作中,研发同学只在 coding 阶段中不须要他人关怀本人的代码,其余须要将本人的产出展现给他人的场景变得非常常见。

简略举几个例子:

  • feature 准入后,同产品业务线的共事须要 trans-review

  • mentor 每个季度要 Lint-review

  • 测试二轮后要 diff-review

  • ……

团队中的每个人都会用不同的视角来“扫视”你的”作品“,那么咱们如何拿出一份像艺术品一样的我的项目代码,而后取得共事们的称誉呢?

放弃在我的项目中做到以下几点,便可播种殿堂级的艺术代码。

以下几点是在接手销售转化零碎及质检零碎等几个我的项目后,针对本人的不 a 足和团队成员交换得出的论断。

01 应用 meaningful 的变量命名

在申明一个变量的时候,尽可能的将其作用和充当的角色注入其中:

申明一个函数,应用组合动词而非名词:

申明一个汇合外部蕴含多项内容的时候,要记得应用复数模式:

在应用数学计算公式的时候尽量提前申明好常量,常量的注入有助于晋升你在保护代码阶段的可读性:

在回调函数或者函数申明的形参中,尽量放弃形参的语义化,防止前期保护过程中看到后面随便申明的 i,j,k 后,又要折返到原回调处进行查看,影响开发效率:

(同时在应用 TS 的过程中也尽量避免应用 any 类型,应用这种类型在 codeReview 过程中可能会被灵魂拷问)同时在申明 boolean 类型的时候要以 is 作为结尾:

做到以上这些,在 codeReview 中就能够放弃一个自信的状态去承受共事们领导们的审阅,因为没有犯低级谬误能够让查看你代码的人放弃情绪愉悦,同时这种情绪能够对你产生正反馈。

02 每个函数只做一件事

每个函数尽量放弃其职责的单一性,不要呈现一个十分健壮的函数做了很多事件:

And 这种单词自身就不是函数的一部分,他会导致增加过多的业务依赖或职责到以后的函数中,从久远的角度看这相对是弊大于利的。

03 让函数放弃 ” 纯净 ”

在函数外的任何货色,任何变量都不是他的业务,所以好的函数应该和函数外的任何变量放弃好隔离。

上面这段代码可能只有刚入门的老手才会写进去,然而这种凌乱的逻辑在业务简单了之后,很可能会混入‘你’的代码中:

下面的例子能够改成上面这样:

当然在 ES6 的应用过程中上述问题广泛曾经不存在了,但 纯函数的思维 须要时刻谨记。

04 模块化业务逻辑

当你在创立了一些函数之后,发现他们在以后的业务中做了一些比拟相似的行为。例如,验证用户登陆的用户名和明码,那么咱们最好能够将其归类为一个模块中。

这里咱们能够称之为验证模块,而 不是简略的应用一个 util 或者 server 将其集中起来 就完事了:

05 简化条件逻辑

如果一个业务中呈现了大量的 if else 这种内容,想必开发人员看到会非常头痛。

举个简略的例子:

认真看下这里的 else 其实是不须要的,咱们能够通过提前返回来 remove 掉:

06 enrich u Error log

当咱们浏览某个 App 或网站时,常常会在点击某个按钮弹出“An Error Occurs”这种提醒,这种提醒很不敌对,咱们无奈排查到底呈现了什么起因,用户更是一头雾水,然而如果在呈现这种谬误的时候将形容信息填充的残缺些,对用户或是技术支持都会有一个很棒的应用体验。

例如:当用户在表单中没有输出信息:

当用户此时网络呈现了故障:

对开发者而言,一个详尽的提醒能让你轻松定位到问题,节俭了大量的工夫:

蕴含但不限于这几种谬误格局,还有 showMessage 等办法能够提供 ……

07 利用好编辑器中的插件

在 VSCode 下开发的同学,能够通过装置 prettier 来放弃丑陋的代码。同时借助 ESLint 能够让你在开发时重视缩进、空格这些格式化的内容。

如果在开发过程中注入了 TS,那么开启 typescript-eslint 会帮忙你标准本人的类型定义,塑造一个格调谨严的代码 style。

借助这些插件让咱们的代码格式化工夫大大降低,从而咱们能够将更多的工夫放在晋升代码品质上。

08 总结

以上列举的几个例子较为简单。通过这些通俗易懂的例子,大家在工作中依据本人的了解触类旁通的使用起来。那便是起到了作用。

在开发中切勿眼高手低,在编码上做到精打细算,对咱们技术的成长会有很大帮忙。

唯有坚持不懈,几十年如一日的训练能力见证技术圈的匠人诞生。共勉!

-END-

正文完
 0