代码规范(审查版).docVIP

  • 8
  • 0
  • 约9.44千字
  • 约 20页
  • 2017-01-06 发布于重庆
  • 举报
代码规范(审查版)

1?目的 为了统一公司软件开发的设计过程中关于代码编写时的编写规范和具体开发工作时的编程规范,保证代码的一致性,便于交流和维护,特制定此规范。 2?范围 本规范适用于开发组全体人员,作用于软件项目开发的代码编写阶段和后期维护阶段。 3?注释规范 3.1?概述 a)??注释要求英文及英文的标点符号。 b)??注释中,应标明对象的完整的名称及其用途,但应避免对代码过于详细的描述。 c)?? 每行注释的最大长度为100个字符。 d)??将注释与注释分隔符用一个空格分开。 e)??不允许给注释加外框。 f)?? 编码的同时书写注释。 g)?? 重要变量必须有注释。 h)?? 变量注释和变量在同一行,所有注释必须对齐,与变量分开至少两个“Tab”键。 如:int? m_iLevel,m_iCount;???? // m_iLevel tree level // m_iCount count of tree items string m_strSql;??????????? //SQL i)???典型算法必须有注释。 j)???在循环和逻辑分支地方的上行必须就近书写注释。 k)???程序段或语句的注释在程序段或语句的上一行 l)???在代码交付之前,必须删掉临时的或无关的注释。 m)???为便于阅读代码,每行代码的长度应少于100个字符。 3.2??自建代码文件注释 对于自己创建的代码文件(如

文档评论(0)

1亿VIP精品文档

相关文档