初識(shí)Java單元一Java概述Java程序運(yùn)行機(jī)制Java程序開(kāi)發(fā)Java注釋目錄CONTENTS12341.4Java注釋1、為什么要有注釋?

假設(shè)一個(gè)程序員新進(jìn)入一個(gè)項(xiàng)目組，接手一個(gè)已離職程序員未完成的軟件模塊功能，當(dāng)他打開(kāi)原程序員編寫(xiě)的代碼時(shí)，其中一個(gè)方法可能有上百行代碼，沒(méi)有任何注釋。這樣造成的結(jié)果是，新程序員要花費(fèi)很長(zhǎng)的時(shí)間去理解原程序員的業(yè)務(wù)邏輯和思路，可能還會(huì)出現(xiàn)理解錯(cuò)誤的情況。怎么解決這個(gè)問(wèn)題呢？在一個(gè)規(guī)范化的軟件開(kāi)發(fā)項(xiàng)目組里，程序的編寫(xiě)是必須要有注釋的，Java程序編寫(xiě)也不例外1.4Java注釋2．什么是注釋?

Java程序中的注釋就是方便程序閱讀而寫(xiě)的一些說(shuō)明性的文字。通過(guò)注釋提高Java源程序代碼的可讀性，使得Java程序條理清晰，易于理解。Java的注釋有3種：?jiǎn)涡凶⑨?、多行注釋、文檔注釋。

//

注釋一行

/*......*/注釋若干行/**......*/注釋若干行，并寫(xiě)入javadoc文檔1.4Java注釋3、編寫(xiě)注釋的規(guī)范

（1）注釋要簡(jiǎn)單明了（2）邊寫(xiě)代碼邊注釋?zhuān)薷拇a的同時(shí)修改相應(yīng)的注釋?zhuān)员ＷC注釋與代碼的一致性（3）保持注釋與其對(duì)應(yīng)的代碼相鄰，即注釋的就近原則，通常是放在該段代碼的上方或者放在該行代碼的右邊（單行注釋?zhuān)?.（4）注釋量要適中。在實(shí)際的代碼規(guī)范中，要求注釋占程序代碼的比例達(dá)到20%左右（5）全局變量要有較詳細(xì)的注釋?zhuān)üδ堋⑷≈捣秶?、方法存取時(shí)的注意事項(xiàng)等說(shuō)明（6）源文件頭部要有必要的注釋信息，包括文件名，版本號(hào)，作者，生成日期，模塊功能描述，主要方法清單及本文件歷史修改記錄等（7）方法前面要有必要的注釋信息，包括方法名稱(chēng)，功能描述，輸入、輸出及返回值說(shuō)明，拋出異常等1.4Java注釋下面是第一個(gè)Java程序增加注釋后的完整程序。/***CopyRightInformation :blue-dot*Project :blue-bridge*JDKversionused :jdk1.8.0*Author :JackYang*Version :2.1.0,2021/11/1**/publicclassHelloWorld{/***Description:主函數(shù)，程序入口*@paramString[]args*@returnvoid*/publicstaticvoidmain(String[]args){System.out.pri