zoukankan      html  css  js  c++  java
  • 团队编程项目作业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.、其他注释

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

  • 相关阅读:
    Java实现 蓝桥杯 历届试题 网络寻路
    Joda-Time 简介
    Eclipse自动生成返回值对象的快捷键是什么?
    eclipse中使用Maven管理java工程设置jdk版本为jdk1.8
    Windows10系统下,彻底删除卸载MySQL
    win10 安装 mysql解压版安装步骤
    使用MySQL Workbench建立数据库,建立新的表,向表中添加数据
    ubuntu安装mysql可视化工具MySQL-workbench及简单操作
    MySQL Linux压缩版安装方法
    【Linux】MySQL解压版安装及允许远程访问
  • 原文地址:https://www.cnblogs.com/Zlxz/p/7792535.html
Copyright © 2011-2022 走看看