码迷,mamicode.com
首页 > 其他好文 > 详细

代码书写规范和命名规范

时间:2014-07-24 23:47:15      阅读:274      评论:0      收藏:0      [点我收藏+]

标签:代码书写规范、命名规范

    上一篇给大家分享了一下,关于文档编写的几个概念。这篇文章阐述如果编写代码书写规范以及命名规范文档。【以java语言为例】

    1、代码书写规范

    代码书写规范,能够让不同的人,写出相同风格的代码。很多人都看过java源代码,你会发现java源代码的整体风格几乎是一致的,但是你要知道编写源代码的人是很多的,如何才能让他们写出同一风格的代码呢?这就是代码书写规范的作用。

    代码书写规范描述的是如何从头到尾书写代码(自己定义的)。通俗点讲就是如何书写java文件。就像你写毕业论文一样,从头到尾每个细节都是有要求的,诸如格式要求,符号要求等等。所以你会发现一个学校里的人写出来的毕业论文,大体格式都是一样的。其实代码书写规范也就是这么一回事。

    java文件,通常可以分为这么几个部分:

    a、申明包(package)

    b、引入包(import)

    c、类定义(class)

    d、类属性

    e、类方法

    基本上就是上述这些大块,现在我给这些大块定义一个格式:

    <package部分>

    <空一行>

    <import部分>

    <空一行>

    <注释>

    <类定义class>

    <private属性>

    <privagte静态属性>

    <默认属性>

    <protected属性>

    <protected静态属性>

    <public 属性>

    <public 静态属性>

    <类启动块>

    <static启动块>

    <无参构造方法>

    <.........>

    就如同上述这种方式,每一个位置,都有严格的格式定义,如果不同的开发人员都按照这样的方式书写,那么写出来的代码不就是同一个风格吗?这就是代码书写规范的用处。

        

    2、命名规范

    有了代码书写规范的格式要求,那么对变量等命名的同一,就是命名规范的作用了。往往命名规范要比代码书写规范要求更加直接一点,而且应该是开发中必须的,以前在开发中,就受尽了这种因为命名不统一而带来的痛楚。

    往往不同语言的常用命名规则不同,市面上也有很多标准命名规范。我认为其实没有谁好谁坏,只要大家都统一使用某一种命名规范,这就可以了!

    命名规范,就是教你如何去命名一个标识(变量名、类名、方法名、包名等等)。具体如何命名,这里不做详述,您可以参考文章的附件。

    注:

        附件是代码书写规范和命名规范,供有兴趣的人参考。有好的建议,大家一起交流!

本文出自 “java程序冥” 博客,请务必保留此出处http://793404905.blog.51cto.com/6179428/1529833

代码书写规范和命名规范,布布扣,bubuko.com

代码书写规范和命名规范

标签:代码书写规范、命名规范

原文地址:http://793404905.blog.51cto.com/6179428/1529833

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!