• 团队编程项目作业2-爬虫豆瓣top250项目代码设计规范


    来自队长http://www.cnblogs.com/z-xx/p/7592127.html

    一、程序风格:

      1.严格采用阶梯层次祖师程序代码

      各层次锁紧的分割采用VC的缺省风格 , 即没层次锁紧为4格、括号位于下一行。要求相匹配的大括号在同一列 ,对继行则要求在缩进4格。

      2.对变量的定义、尽量位于函数的开始位置。

    二、命名规则:

      1.变量名的命名规则

        1)、变量命名规则要求用“匈牙利法则”。即抬头字母用变量的类型,其余部分用变量的英文意思或者其英文意思的缩进,尽量避免用中文的拼音,要求单词的第一个字母应大写

      对非通用的变量,在定义时加入注释说明,比那辆定义尽量可能放在函数的开始处。

        2)、对常量命名,要求常量名大写,常量名用英文表达其意思。

        3)、函数命名规范

          函数的命名应该尽量用英文表达出函数完成的功能。遵循动宾结构的命名法则,函数名中动词 在前,并在命名前加入函数的前缀,函数名的长度不得少于8个字母。

        4)、文件名的命名规范

        文件名的命名要求表达出文件的内容,要求文件名的长度不得少于5个字母

    三、注释规范:

      1.、函数头的注释

       对于函数,应该从“功能”、“参数”、“返回值”、“主要思路”、“调用方法”、“日期”留个方面注释

      2、变量的注释:

      对于变量的注释紧跟在变量的后面说明变量的作用。原则上对于每个变量应该注释。但对于意义非常明显的变量。

      3、文件的注释:

      文件应该在文件开头加入以下注释:

      //////////////工程:文件所在的项目名。

      //说明文件的功能

      //对文件修改内容 日期 原因 

      //说明文件的版本,完成日期

      4.、其他注释

      在各个模块功能的每一主要部分之前添加块注释,注释每一组的语句,再循环。流程的各个分支等,尽可能的多家注释

  • 相关阅读:
    Python编程题44反转链表
    Python编程题45移除链表元素
    docker Redis 安裝路徑
    2: 写一个demo(zeppeline 上用flink SQL 读kafka数据)
    1: docker 安装 zeppeline
    3: 读取kafka数据写如mysql
    Linux 远程挂载 Ceph RBD 磁盘
    【Linux网络编程】字节序
    【Linux命令】iptables 禁止 IP和端口
    Jenkins发布服务报错Fatal error: put encountered an exception while uploading磁盘空间不足处理 No space left on device
  • 原文地址:https://www.cnblogs.com/npqnpq/p/7601479.html
Copyright © 2020-2023  润新知