一个声明,一般至少包含两个部分,一个是标识符的名字,一个是标识符的类型。比如:int size;
有的声明,还有修饰和限定部分,比如 Java 的访问控制修饰符(private,public 等):private int size;
或者 C 语言的存储类别限定符(auto,extern 等):auto int size;
在 Java 语言里,声明可以用来定义类、方法、类变量、局部变量和常量等。
一行一个声明
我们一般在定义变量时会把相同类型的变量声明在同一行:int size, length;
这样确实方便了使用,语言也支持这种灵活性,但是这样对代码的变更和维护不太友好。比如我们想对第一个变量添加注释,后面变量的位置要对应变化。不如直接一行定义一个变量,直观、整洁也方便维护。
局部变量需要时再声明
大家在看别人代码的时候会有这样的经验:很长的代码文件,一段代码中的局部变量向上找了好久才找到,浪费了时间。
所以标识符的声明应该和它的使用尽可能地靠近,特别是局部变量的标识符声明。在视觉上,标识符的定义和使用,可以方便我们阅读和记忆。
类属性要集中声明
在写一个类时,类变量的声明则要集中。因为无论类变量是私密变量还是公开变量,在类的方法实现中,随时都可以调用。我们需要把这些变量放在一起,以便于修改和查找,方便开发者和其他阅读者的阅读和记忆。
声明时就初始化
声明时初始化,可以防止初始化的遗漏或者不必要的代码重复。
当然,如果变量的初始值依赖于更多的条件,或者涉及到一定的计算,也可以在其他位置初始化。
尾随的花括号
一般来说,类声明和方法声明后,要使用花括号把实现的代码包括进来。
这里只推荐一种格式:
class Test { //左括号不单独成行,要紧随在语句尾部,以一个空格隔开
// to do
} // 右括号单独成行
紧靠的小括号
小括号一般用来识别一个标识符是不是方法标识符,所以建议小括号要紧靠着标识符,中间不要有空格。
String setName(String name) {
// to do
}
网友评论