代码风格指南

我们不会因为您未检查代码风格而 恢复提交令牌 。请相应地计划并使用正确的风格！您已被警告。

关于此风格指南的一些说明：我们已尝试使其尽可能接近默认的IntelliJ风格检查器。该风格检查器还包括一些IntelliJ不会检查的"代码质量"检查。

通过运行自动风格检查器来了解这些规则可能会更容易。您可以通过在左侧栏中右键单击文件并选择"检查风格"来在IntelliJ中运行风格检查器。这将在所选文件中生成风格错误列表。在再次运行风格检查器之前，请确保保存或重新编译您的文件。

screenshot of intellij with right-click menu open

本代码风格指南可能也不完整。我已尽力使其尽可能全面，但可能遗漏了一些新增规则的描述。

空白字符

case 标签在其封闭的 switch 的基础上再缩进一级，如下所示：

          switch (op) {
   case '+':
         addOpnds(x, y);
         break;
   default:
         ERROR();
}

         

在所有 if 、 while 、 do 和 for 语句的代码块周围使用 { } 大括号。
将 } 大括号放在后续的 else 、 finally 或 catch 放在同一行，例如：
```
if (x > 0) {
   y = -x;
} else {
   y = x;
}
```
将开启代码块的 { 放在行尾。通常，它放在 if 、 for 、 while 、 switch 、 do 、方法头或类头的末尾。如果行长度迫使它换到下一行，则不要缩进它，并将其单独放在一行上。

方法应有javadoc注释说明行为、参数（使用@param标签或其他方式）和返回类型。
返回非void值的方法必须在Javadoc注释中描述返回值，可以使用"@return"标签或在包含"return"、"returning"或"returns"等词的运行文本中描述。
每个Javadoc注释必须以正确形成的句子开头，首字母大写，以句点结尾。

1. 不要 use 'import PACKAGE.*', unless the package 是 java.lang.Math, java.lang.Double, or org.junit.Assert. 'import static CLASS.*' 是确定.

数组类型的"[]"应写在元素类型名称之后，而不是声明符之后。写"String[] names"，而不是"String names[]"。
方法、类或字段的修饰符应按以下顺序编写：
1. public、protected 或 private。
2. abstract 或 static。
3. final、transient 或 volatile。
4. synchronized。
5. native。
6. strictfp。
不要在冗余的情况下显式修饰方法、字段或类：
1. 不要将接口或注解中的方法标记为"public"或"abstract"。
2. 不要将接口或注解中的字段标记为"static"、"public"或"final"。
3. 不要将 final 类中的方法标记为"final"。
4. 不要将嵌套接口标记为"static"。
不要在控制语句中使用空代码块（内部只有空白或注释的"{ }"）。有一个例外：catch 块可以只包含如下形式的注释：
```
/* Ignore EXCEPTIONNAME. */
```
通过给"魔术数字"赋予符号名称来避免在代码中使用它们，例如：
```
public static final int MAX_SIZE = 100;
```
例外情况是数字 -1、0、1、2、3、4、5、6、7、8、9、0.25、0.5。
不要尝试捕获异常、RuntimeError 或错误异常。
写"b"而不是"b == true"，写"!b"而不是"b == false"。

将

          if (condition) {
   return true;
} else {
   return false;
}

         

替换为

          return condition;

         