《Java和Android开发实战详解》——2.5节良好的Java程序代码编写风格

本节书摘来自异步社区《java和android开发实战详解》一书中的第2章，第2.5节良好的java程序代码编写风格，作者 陈会安，更多章节内容可以访问云栖社区“异步社区”公众号查看

2.5 良好的java程序代码编写风格

java和android开发实战详解

java代码是由程序语句组成的，数个程序语句组合成一个程序块，每一个块拥有数行程序语句或注释，一行程序语句是一个表达式、变量和命令的程序代码。

2.5.1 程序语句

java程序由程序语句（statement）组成，一行程序语句如同英文的一个句子，内含多个表达式、运算符或java关键字（详见第3章的说明）。

1．程序语句的范例

一些java程序语句的范例，如下所示：

2．程序语句结束符号“;”

“;”符号代表程序语句的结束，它告诉编译器已经到达程序语句的最后。换句话说，我们可以使用“;”符号在同一行编写多个程序语句，如下所示：

上述一行代码即拥有3个程序语句。

2.5.2 程序块

程序块（block）是多条程序语句的一个集合，使用“{”和“}”符号包围起来，如下所示：

上述main()方法中的代码部分是一个程序块，在第4章和第5章将介绍的流程控制语句和方法都拥有程序块。

java语言属于一种“自由格式”（free-format）的程序语言，我们可以将多个程序语句写在同一行，甚至也可以将整个程序块置于同一行，程序设计者可以自由编排程序代码，如下所示：

2.5.3 程序注释

程序注释是程序的重要部分，因为良好的注释文字不但有助于了解程序的目的，并且在程序维护上，也可以提供更多的信息。

java语言的程序注释是以“//”符号开始的行，也可以将它们放在程序行后，如下所示：

system.out.println("第一个java程序"); // 显示信息

如果注释文字较长，需要跨多行，我们可以使用“/”和“/”符号标示注释文字，如下所示：

2.5.4 避免太长的程序代码

如果一条语句的程序代码太长，基于易于阅读的需求，我们可以将它分成两列来编排。因为java语言属于自由格式的程序语言，并不需要使用任何符号，直接分成两行即可，如下所示：

不过在程序代码分割时需要保持程序元素的完整性，例如：关键字、完整字符串或运算符，请注意！不可以将一个字符串断开分成两行。

2.5.5 程序代码缩排

记得使用缩排程序代码。适当地缩排代码，可以让程序更加容易阅读，并且容易反映出程序代码的逻辑结构。例如：将循环块中的程序代码缩几格编排，如下所示：

向内缩排可以清楚分辨哪些程序代码属于同一个程序块。事实上，程序编写风格并非一成不变，程序设计者可以自己定义所需的程序编写风格。