编码规范

高质量代码的三大要素:

可读性、可维护性和可变更性

   做好代码规范、提高代码质量,能显著增强代码的可读性、可维护性和可变更性。本文将这三大要素合称为代码的读写可维护性,努力提高代码的读写可维护性,是做好代码规范的必要非充分条件。代码规范和架构设计是软件的灵魂所在,代码质量偏低,就像是人失去了三魂七魄中的一魄,就会丧失活力,影响正常运行,增加软件交付后维护成本,出现推迟完成、超出预算、特性缺失等现象。

    任何语言都需要强调编码风格的一致性。只要是团队开发,每个人都以相同的方式编写代码就是至关重要的。这样大家才能方便地互相看懂和维护对方的代码。

代码规范

   如果不想为以后挖坑,做好代码规范是程序员和团队负责人、项目经理的必修课。如何保证当前项目开发过程中压力正常,而不是在后期面对过多的压力、以至于噩梦缠身?最简单的办法就是照看好你的代码,也就是落实好公司的代码规范工作。每天为此付出一丁点的努力,便可以避免代码「腐烂」,并保证代码产品日后不至于变得难以理解(可读性)和维护(可维护性)。

代码的可读性

代码的可读性是指代码让人容易阅读、跟踪和理解的程度。提高代码的可读性可以为代码阅读者节约时间(避免阅读时浪费过多无谓的时间)和精力(Debug、扩展功能或是性能优化的前提条件是你要读懂这段代码)。以下是摘选的可供参考的策略:

  • 编码风格一致
  • 代码清晰表达意图
    • 写人看得懂的单词,如果选用英语,那么避免日语、法语和汉语拼音等,尽量使用语义化的命名组合;
    • PIE 原则:意图清楚而且表达明确地编程;
    • 能够让人快速看懂(最低限度的要求是自己一个月后能快速读懂);
  • 恰到好处的注释
    • 不能太多或太少,注释的形式根
      据代码具体的情况有不同;
    • 避免用注释包裹代码;
    • 尽量留下简明扼要的注释;
  • 评估取舍
  • 避免写一些现在不需要、将来也不太可能需要的功能:
    • 不完美主义:不多写代码(如会话存储拆分);
  • 避免做没有太大价值的优化工作;
  • 区分任务的轻重缓急:
    • 头疼医头也医脚:先容忍失败,再解决问题(如节点关闭逻辑);
    • 不头疼不医头:量化分析(如参数调整回滚等);
  • 综合考虑一下性能、便利性、生产力、成本和上市时间……
  • 简单就是美,避免简单的功能写出复杂的代码;
  • 保持简单的代码远比写出复杂代码要难得多,但这是值得的;
  • 不编写讨巧的代码;
  • 避免无谓的条件嵌套和过度封装;
  • 第一眼看上去就能知道其用处的代码,才是简单而美的代码;
  • 坚持操作方法的原子性,而后使用组合模式实现业务逻辑;
  • 避免大段代码,要写高内聚、低耦合的代码;

** 代码的可维护性**
  软件可维护性是指理解、改正、改动、改进软件的难易程度。通常影响软件可维护性的因素有可理解性、可测试性和可修改性。笔者这里将其分为两大类:编写时可维护性和运行时可维护性。

编写时可维护性
  编写时可维护性是指在程序或系统上线后爆出 BUG,开发团队能够及时扑灭这个 BUG 且不会爆出其他 BUG。保持方法的原子性,提高代码内聚,能使某处修改的影响降到最低,这样某处方法出现 BUG,也不太会影响到其他模块的正常运作。编写时可维护性还包括了代码的「可测试性」。

  JavaScript Module AMD 标准执行者(如 require.js)和 CMD 标准执行者(如 sea.js)要求谨慎使用全局变量,将变量限制于一个个模块之中,使得 JavaScript 代码变得更有条理且更便于维护。

运行时可维护性
  运行时的可维护性是指在系统运行过程中(或无需再次编码发布、只需系统重启一次)修改系统的某项配置并使其生效,且不影响现在正在进行的业务和用户的操作。这要求软件工程师不能把代码写死。例如配置文件、数据库连接字符串、资源文件、日志等。

代码的可写性
代码的可写性包括「代码的可变更性」,代码的可变更性是软件理论的核心,OOSE 花了极大篇幅都在讲软件的变更;敏捷开发则天然地要求软件产品具有高逼格的可变更性。
代码的可写性是建立在代码的可维护性上的,而代码的可写性与可维护性又都建立在代码的可读性上。如果代码难以阅读,那么 BUG 的修正将变得难以入手,新功能的添加就更是无从入手了。
不过前人已经为我们指明了许多方向,例如设计模式、RDD、TDD、DDD 等。使用设计模式可以显著提高代码的可写性,尽管设计模式看上去难以理解且高深莫测,但通过多阅读优秀代码、优秀框架,多通过社区、群、博客、邮件组和小面积聚会与在此道经验富于己者交流,能让自己的水平快速上升。最关键的是多实践,实践是检验真理的唯一标准,也是掌握技术的唯一法门
「(程序员)富有探寻事物本质之精神」便是此理。程序员几乎无一例外地会将自己看到的能使自己进步的知识与技巧立即(或不久之后)进行尝试(实践)。

代码重构
代码重构是代码可写性的一种特殊情况,把不稳定的积木塞塞紧。软件开发的整个过程也是一个不断迭代、不断优化、不断重构的过程。代码重构旨在不改变现有功能的基础上,通过调整程序代码改善软件的质量、性能,使其程序的设计模式和架构更趋合理,提高软件的扩展性(可写性)和维护性(可维护性)。
重构的目的是最大限度避免软件走向生命周期的终结(维护开发成本高于开发一个全新产品的成本时,老的软件便步入了生命周期的晚期)。通过不断重构,纠正和改进软件设计,使代码更易为人所理解,有助于寻找到隐藏的代码缺陷,使系统对新需求的变更保持较强的适应能力(可写性)。
关于重构的知识就此打住,强烈建议感兴趣的读者购买《重构:改善既有代码的设计》和《大话重构》这两本书。

代码检查
代码检查应采取自动化检测与人工代码审查相结合的方式进行,后者倾向于更为重要的设计错误上(如 BUG、竞态条件和潜在死锁等)。
代码检查的目的是理解代码,改进代码,确保代码能正常工作,而不是批评任何人。
关于代码检查清单,可以阅读这篇文章;关于代码审查的专业知识与技能不是本文关注的重点,可以先阅读这篇文章,然后购买相关的专业书籍进行学习。

编码规范推荐
以下是一张可供参考的编码规范示例。

垂直居中有几种实现方式

方法1:table-cell

html结构:

1 <div class="box box1">
2 <span>垂直居中</span>
3 </div>

css:
1 .box1{
2 display: table-cell;
3 vertical-align: middle;
4 text-align: center;
5 }
方法2:display:flex

 1 .box2{
 2  display: flex;
 3  justify-content:center;
 4    align-items:Center;
 5 }

方法3:绝对定位和负边距

.box3{position:relative;}
.box3 span{
        position: absolute;
        width:100px;
        height: 50px;
        top:50%;
        left:50%;
        margin-left:-50px;
        margin-top:-25px;
        text-align: center;
    }

方法4:绝对定位和0

 1 .box4 span{
 2  width: 50%; 
 3  height: 50%; 
 4  background: #000;
 5 overflow: auto; 
 6 margin: auto; 
 7  position: absolute; 
 8   top: 0; left: 0; bottom: 0; right: 0; 
 9 }

这种方法跟上面的有些类似,但是这里是通过margin:auto和top,left,right,bottom都设置为0实现居中,很神奇吧。不过这里得确定内部元素的高度,可以用百分比,比较适合移动端。

方法5:translate

 1 .box6 span{
 2   position: absolute;
 3  top:50%;
 4   left:50%;
 5  width:100%;
 6  transform:translate(-50%,-50%);
 7     text-align: center;
 8    }

这实际上是方法3的变形,移位是通过translate来实现的。

方法6:display:inline-block

  1 .box7{
  2  text-align:center;
  3  font-size:0;
  4 }
  5 .box7 span{
  6  vertical-align:middle;
  7   display:inline-block;
  8  font-size:16px;
  9 }
  10 .box7:after{
  11  content:'';
  12  width:0;
  13   height:100%;
  14   display:inline-block;
  15   vertical-align:middle;
  16 }

这种方法确实巧妙...通过:after来占位。

方法7:display:flex和margin:auto

1 .box8{
2 display: flex;
3   text-align: center;
4 }
5 .box8 span{margin: auto;}

方法8:display:-webkit-box

.box9{
display: -webkit-box;
-webkit-box-pack:center;
-webkit-box-align:center;
-webkit-box-orient: vertical;
text-align: center

}
方法9:display:-webkit-box

这种方法,在 content 元素外插入一个 div。设置此 div height:50%; margin-bottom:-contentheight;。

content 清除浮动,并显示在中间。

<div class="floater"></div>  
  <div class="content"> Content here </div>  

.floater {
float:left; 
height:50%; 
margin-bottom:-120px;
}
.content {
clear:both; 
height:240px; 
position:relative;
}

效果范例

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,847评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,208评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,587评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,942评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,332评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,587评论 1 218
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,853评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,568评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,273评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,542评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,033评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,373评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,031评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,073评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,830评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,628评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,537评论 2 269

推荐阅读更多精彩内容