• 代码规范值钱吗?分享内部不成熟的代码规范做法。


    一、规范目的:

    规范的目的是提高代码可读性,阅读的舒适性,减少维护的成本,方便后续运维,让运维人员看到别人写的代码就像自己写的代码。
    随着需求的增加,代码必然是越堆越多,越来越乱,最后失控导致项目腐烂。
    物理学上的让我们理解了一件事,如果不施加外力影响,事物永远向着更混乱的状态发展。比如,房间如果没人打扫,只会越来越乱,不可能越来越干净。

    二、规范要点

    1.局部变量首字母小写(Camel),全局变量统一加下划线开头。

    • 全局变量统一加下划线
    • 局部变量首字母小写

    2.格式化规范

    为了可读性,所有的代码必须格式化。
    • 错误示范:

      中间不要出现无效的空格,影响代码可读性。
    • 正确示范:

     

    3.枚举的规范

    • 错误示范:
    • 正确示范:
     

    4.命名规范

      命名规范遵循原则:
    • 简单
    • 可读
    • 统一
       规范是需要成本的。
      要做到这三个方面,仅仅是靠规范文档是很困难的。大家对简单,可读,统一的理解各不相同,最后生成的代码必然是千人前面,所以必须引入代码审查机制。理论上需要对业务的深入了解,需要有很好的英文功底,编程功底的人来做代码审查是最优选 。
       流程:可操作的规范文档定制和讨论==>核心模块的命名拟定和讨论==>资深开发人员的代码审查==>
    4.1常用变量名称要统一命名。
      返回是否成功命名:isSuccess
      1)局部变量第一个字母统一小写
      2)是否成功统一下:isSuccess
    • 错误示范:
    • 正确示范:
    4.2上层模型命名和底层数据模型保持一致
      严格按照DB模型为指导命名,保证整体系统的命名一致性,方面后续运维良好的代码可读性。
    • 错误示范:
    该接口是消息回复,这里的注释和命名都是不对的。Replay已经在DB模型出现过,所以必须和DB模型命名保持一致,不能自己另外命名。
    注释必须准确,新增消息的注释和另外一个add接口重复
     
    4.3画蛇添足
      DB命名画蛇添足,违背了简单原则
    • 错误示范:
    4.4不要使用语焉不详的数字
    • 除了SQL,尽量不要使用可读性不好的数字。
    4.5复杂不可读紊乱命名
    • 错误示范
    UserLogin不如Login
    addUser和其他命名大小写不一致
    CountryLogo和其他两个命名结构不一致,一个是名词,一个是动宾结构。

    5.其他细节规范

    • 错误示范:
    • 正确示范:

     6.代码审查

    • 负责人审查
    • 小组讨论会
      规范的关键是审查,否则必然会变成形式。引入审查就意味着成本,对中小团队来说一个月可能一次就足够了。
     
  • 相关阅读:
    wpf图片查看器,支持鼠标滚动缩放拖拽
    Python 3.x 学习笔记--杂
    Python 3.x 模块
    python 连接kafka
    Oracle问题
    Device Mapper Multipath(DM-Multipath)
    各种书籍
    Centos 6.x系统
    老男孩Python 3.x 讲义
    Python 3.x 学习笔记
  • 原文地址:https://www.cnblogs.com/jackyfei/p/11933600.html
Copyright © 2020-2023  润新知