一篇文章带你入门Java之编程规范

• java注释

引言

♀ 小ad：小明哥，之前你教我的helloworld实例我写完了，超级简单呢，我一下子就搞定了
♂ 明世隐：是吗，那不错哦。
♀ 小ad：我还举一反三、*发挥了一波
♂ 明世隐：这波怎么说？
♀ 小ad：怎么说？我说我在第5层，你信不
♂ 明世隐：我信，你举的什么、反的什么？
♀ 小ad：我写了个小鲁班连招类，可以顺序释放连招，好玩。
♂ 明世隐：挖槽，你这波是要在大气层吗？上头了吧你。
♀ 小ad：明哥别这样说，我就觉得好玩
♂ 明世隐：好，我觉得你脑子转的挺快，来给明哥看看。
♀ 小ad：好的，代码给你看看

package learnjava;
public class 鲁班连招类 {
	public static void main(string[] args) {
		system.out.println("发现敌人");
		system.out.println("释放3技能");system.out.println("平a1");system.out.println("平a2");
system.out.println("平a3");system.out.println("平a4");
			system.out.println("释放1技能");
			system.out.println("平a1");system.out.println("平a2");system.out.println("平a3");system.out.println("平a4");
system.out.println("释放2技能");system.out.println("平a1");system.out.println("平a2");
			system.out.println("平a3");system.out.println("平a4");
			system.out.println("敌人已经被消灭");}}

运行代码

♀ 小ad：明哥，咋样？我这连招，ko敌人，刺客突脸我可以把2技能先放
♂ 明世隐：很（yao）好（lao）耶（ming）
♀ 小ad：那可不！我觉得我可以统治下路了。
♂ 明世隐：你的为啥放技能后要平a4下。
♀ 小ad：因为这个平a 4下我用来代表的是小鲁班的被动扫射效果，表示攻击速度很快。
♂ 明世隐：嗯嗯，真不错，有编程的天赋，看来我选对了徒弟哈，但是，还是让我来说说你的问题。
♀ 小ad：？？？
♂ 明世隐：我说让我来说说你的问题。
♀ 小ad：有什么问题，我这连招不好吗？你上次教我的，你是不是藏了什么？
♂ 明世隐：你耗子未汁吧你！
♀ 小ad：明哥，直接说吧，别这样
♂ 明世隐：我说你代码写的乱七八糟。
♀ 小ad：没问题啊，你看我不是运行给你看了吗？结果犀利
♂ 明世隐：确实犀利，我说的是代码很乱。
♀ 小ad：我不懂你的意思
♂ 明世隐：就是不规范。
♀ 小ad：哦，我不知道哦，那你给我讲讲呗
♂ 明世隐：来，下次写这样的代码，别在朋友圈发说你认识我，我老脸往哪里放。
♀ 小ad：（大写的尴尬）

命名规则

类名首字母应该大写。字段、方法以及对象（句柄）的首字母应小写。对于所有标识符，其中包含的所有单词都应紧靠在一起，而且大写中间单词的首字母。例如：

thisisaclassname

thisismethodorfieldname

命名规则必须遵循以下规则：

1)、名称只能由字母、数字、下划线、$符号组成

2)、命名时不能以数字开头

3)、在命名是绝对不能出现java关键字。

4)、见名识意—看到名字就知道是什么。

当然这些都不是硬性规定，你可以按照自己的想法去命名。但那样的代码可读性很差。

public class 鲁班连招类 {

♀ 小ad：你是说我这个类的命名不满足上面的第一条是吗
♂ 明世隐：可以这么说。
♀ 小ad：那eclipse为什么没有报错。
♂ 明世隐：其实是可以用中文命名的，类名和方法名用中文其实也是可以成功运行的，因为只要是unicode字符，就符合规范，不过这里的规范指的是标识符规范，代码规范是不提倡用中文的。
♀ 小ad：这样啊，那我把类名改成lz
♂ 明世隐：你这是什么意思？
♀ 小ad：lz就是连招的意思啊
♂ 明世隐：可是我看不懂诶！
♀ 小ad：那改lianzhao
♂ 明世隐：类开头用大写，然后采用驼峰命名。
♀ 小ad：那改成lianzhao就可以撒
♂ 明世隐：你为什么不用英文来命名，用拼音感觉不舒服。
♀ 小ad：那连招的英语是什么？
♂ 明世隐：你问我干嘛？我不会
♀ 小ad：哈哈，明哥你都不会啊，我也不会。
♂ 明世隐：那说好了，就这样命名了，嘿嘿。

代码排版

1.程序块要采用缩进风格编写，缩进的空格数为4个。

2.在函数体的开始、类和接口的定义、以及if、for、do、while、switch、case语句中的程序都要采用如上的缩进方式。

3.较长的语句、表达式或参数（>80字符）要分成多行书写，长表达式要在低优先级操作符处划分新行，操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。

4.if, for, do, while, case, switch, default 等语句自占一行，且if, for, do, while等语句的执行语句无论多少都要加括号{}。

5.相对独立的程序块之间、变量说明之后必须加空行。

6.出现分号尽量换行。

♀ 小ad：哥，那么多那么麻烦，我都看不明白.
♂ 明世隐：其实也不用刻意去记，我帮你把代码编辑一下你就很容易看明白。
♀ 小ad：好

针对你的代码分4步

1.代码缩进对齐

修改后：

package learnjava;
public class lianzhao {
	public static void main(string[] args) {
		system.out.println("发现敌人");
		system.out.println("释放3技能");system.out.println("平a1");system.out.println("平a2");
		system.out.println("平a3");system.out.println("平a4");
		system.out.println("释放1技能");
		system.out.println("平a1");system.out.println("平a2");system.out.println("平a3");system.out.println("平a4");
		system.out.println("释放2技能");system.out.println("平a1");system.out.println("平a2");
		system.out.println("平a3");system.out.println("平a4");
		system.out.println("敌人已经被消灭");}}

2.遇到分号换行

修改后：

package learnjava;
public class lianzhao {
	public static void main(string[] args) {
		system.out.println("发现敌人");
		system.out.println("释放3技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("释放1技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("释放2技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("敌人已经被消灭");}}

3.大括号、括号等成对出现

修改后：

package learnjava;
public class lianzhao {
	public static void main(string[] args) {
		system.out.println("发现敌人");
		system.out.println("释放3技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("释放1技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("释放2技能");
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("敌人已经被消灭");
	}
}

4.加上注释

♀ 小ad：明哥什么是注释啊
♂ 明世隐：注释就是说明
♀ 小ad：说明什么？
♂ 明世隐：说明这个类是用来做什么的，这个方法是什么功能等。
♀ 小ad：好像明白了一点
♂ 明世隐：给你举个例子，你就完全清楚了。

♂ 明世隐：上面的图知道什么意思吧
♀ 小ad：当然啊，就是技能说明呗
♂ 明世隐：对啊 ，那你如果不熟悉技能的话，你不是可以看看这个技能干啥用的，有多少伤害、冷却时间多少、蓝耗多少吗？
♀ 小ad：是的，没有这个说明，除非对这个英雄比较熟悉，否则就不知道了。
♂ 明世隐：那你拿到一段代码的时候，如果没有说明，你可能搞不清楚这个代码是干嘛的吧。
♀ 小ad：嗯，但现在这个代码我知道 啊
♂ 明世隐：目前你当然是知道的，因为第一这个代码简单，容易看明白，如果逻辑复杂的呢？第二记忆都是一段时间的，如果过些时候你再看到某段代码，你也想不起来是干嘛的了，必须一行行的去看代码，然后你才能知道，这样不就很麻烦了吗？
♀ 小ad：好像是这个道理。
♂ 明世隐：所以说就跟这个技能描述一样的，我们也可以改代码加上说明，称之为注释。
♀ 小ad：原来是这个意思啊，那注释应该怎么加？
♂ 明世隐：那我们来加一下吧。

java注释

注释的作用

很多java新手在敲代码的时候都不会在意注释这个东西，但其实，注释在java编程中也是必不可少的。

在学习过程中，我们应该也发现要敲的代码越来越多，越来越繁琐，而且做编程本来就很需要思维逻辑，在碰到需要使用大量代码的时候，就需要在每个关键点做好注释，让我们明白这段代码的含义，同时，如果要请教别人的话，别人看你的代码更加方便。

而在以后的工作当中，肯定会有团队协作的，这种时候，也是非常需要注释的，不然在后期合并的时候是会非常麻烦的。

注释的3种类型

1.单行注释
//内容1
//内容2

2.多行注释
/*
内容1
内容2
*/

3.文档注释
/**
*内容1
*内容2
*/

给代码加上单行注释

public class lianzhao {
	//主函数
	public static void main(string[] args) {
		system.out.println("发现敌人");
		//释放3技能
		system.out.println("释放3技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		//释放1技能
		system.out.println("释放1技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		//释放2技能
		system.out.println("释放2技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("敌人已经被消灭");
	}
}

♀ 小ad：明哥，有句话我想说但不敢说？
♂ 明世隐：说吧，不喷你
♀ 小ad：我感觉你这个注释没什么用，你不加注释，我也知道这个写的是放技能、平a啊，你现在加这个注释也是多余的。
♂ 明世隐：。。。，是这样的，因为你这个代码是最基础的，就一句打印输出，并且输出的内容也写的很清楚，所以你感觉没必要，但在开发中，代码的逻辑就复杂的多，你不加注释别人可能就看不明白你 代码、或者说要花额外的时间去理解你的代码；甚至于你自己再次回过头来看的时候，没有注释，都要重新去阅读代码，才知道是干嘛的。
♀ 小ad：哦，这样啊，那我明白了

给代码加上多行注释

给代码加上文档注释

注释后完整的类代码

package learnjava;
/**
 * 模拟鲁班连招的类
 * @author 小ad
 * @date 2021-07-04
 */
public class lianzhao {
	/*
	 * 主函数
	 * 此函数模拟了鲁班的连招
	 * 3技能+扫射+1技能+扫射+2技能+扫射
	 */
	public static void main(string[] args) {
		system.out.println("发现敌人");
		//释放3技能
		system.out.println("释放3技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		//释放1技能
		system.out.println("释放1技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		//释放2技能
		system.out.println("释放2技能");
		//扫射
		system.out.println("平a1");
		system.out.println("平a2");
		system.out.println("平a3");
		system.out.println("平a4");
		system.out.println("敌人已经被消灭");
	}
}

♂ 明世隐：你看代码是不是比你开始的要好看、工整的多。
♀ 小ad：哇明哥，这样别人看到代码就知道是我写的呀。
♂ 明世隐：对啊 ，就知道你的大名了。
♀ 小ad：哇注释果然很有用。
♂ 明世隐：别光知道可以写上你的大名哈，其他的也很重要。
♀ 小ad：不会不会，我一下就明白怎么用这个注释了，谢谢明哥！

除了上述内容还要注意：如何编写良好的java代码

♀ 小ad：哇明哥，我觉得我好像学java很简单呢
♂ 明世隐：对啊，java本来就不难，关键看你自己愿意学不咯。
♀ 小ad：我当然愿意学，我就感觉跟明哥上分一样简单，紧紧跟着明哥就行。
♂ 明世隐：知道就好，要的就是上分如喝水、学java如张飞吃豆芽。
♀ 小ad：哥你说的什么？也不押韵啊。
♂ 明世隐：你重点是在这吗你？快打开游戏，先上几星再说，你连招不是很溜吗。
♀ 小ad：来，当然了，我边学java又边学连招，今天整爆他们。

总结

本篇文章就到这里了，希望能给你带来帮助，也希望您能够多多关注的更多内容！