zoukankan      html  css  js  c++  java
  • 20190919-5 代码规范

    作业要求参见:https://edu.cnblogs.com/campus/nenu/2019fall/homework/7630

    要求1 《代码规范》包括10项条款。制定条款的目的是在程序设计的过程中(触犯和)约束代码风格,希望切实可行,容易观察和客观检验。

    经阅读《构建之法》第68页至第78页,以及网上学习了解Python编码规范,我和徐姗姗同学共同规定的《代码风格规范》(十项)如下:

    (一)命名规范

    1.函数名必须与题意和目的相关,体现意义,不能用简单字母(如a,b,c等)代替。

     

    (二)格式规范

    2.代码必须严格缩进,用4个空格缩进,不用tab缩进。

    3.每行不超过80个字符。

    4.顶级定义之间空2行,方法定义(函数或类定义)之间空1行。

    5.括号内没有空格。

    6.在逗号、分号、冒号后面加空格。

    7.“=”用于指示关键字参数或默认参数时不在两侧是用空格,作为算数操作符时在两边加一个空格。

    8.如果一个类不继承自其他类,就从object集成,嵌套类同样遵循这一规则。

    9.导入时每个导入占一行。

     

    (三)注释规范

    10.在函数后加简单注释说明其功能,且不能描述代码。为提高可读性,注释离开代码至少2个空格。

     

    要求2 记录完成本周作业过程中,《代码风格规范》执行情况。

    规范编号 纠正次数 原因 修改规范
    (一)1 3 习惯起简单快捷的名字,但不利于理解,尽量用能表达函数功能的英文作为函数名。 保持不变
    (二)2 11 习惯用tab缩进。 保持不变
    (二)3 1 代码中有一行超过了80个字符,用""分隔成三行。 保持不变
    (二)4 7 有时会忽略空两行问题,pycharm会提示。 加强,应养成编程习惯
    (二)5 4 括号内不该加空格时加了空格。 保持不变
    (二)6 10 其中逗号后面加空格纠正次数最多。 加强,应养成编程习惯
    (二)7 3 习惯于无论“=”起什么作用都在两边加空格。 保持不变
    (二)8 1 编写类时对object不熟悉。 保持不变
    (二)9 1 将导入写在了同一行。 保持不变
    (三)10 3 注释没有注重强调功能。 保持不变

    总结:

    1.采用代码规范在很大程度上提高了代码的可读性。规范中的(二)主要来源于google的python编码规范,对于我这样的初学者,应该从学习之初就养成良好的编码习惯。

    2.在结对过程中,对于一个人没有发现的问题或不好理解的部分,可以及时互相指出并纠正,提高了效率。

    3.python语言比较精炼简洁,对于部分编码不规范的地方,pycharm能够给出提示,一定程度上方便了代码规范。

  • 相关阅读:
    总结:Sharepoint2010 Client Object Model Managed Client
    学习:SharePoint验证控件
    学习:Javascript与后台交互(转)
    总结:sharepoint webservice开发常见错误
    Xtreme ToolkitPro 版本更新至 2007 Volume 1
    WebUI Studio.NET® 优秀用户界面控件套装
    Spread v7.0 表格控件中的领头羊
    WebUI Studio.NET® 2007 R1 用户界面套装新版本发布,全面支持AJAX技术
    Skelta SharePoint Accelerator
    磐岩科技控件中国网乔迁新址
  • 原文地址:https://www.cnblogs.com/wkf-/p/11577934.html
Copyright © 2011-2022 走看看