在Java程序中Javadoc注釋很重要，但是很多時候注釋被漏掉，看看項目中的代碼就會知道。如果你結(jié)對編程的話，你的伙伴一定會說，“哥們，這兒注釋丟掉啦，那個函數(shù)的Javadoc注釋寫的不正確！”。項目中有很多的開發(fā)人員，水平和習慣都不太一樣，但是對程序中javadoc注釋來說，這是不能變化的，要規(guī)范起來。如何讓每一個人都能養(yǎng)成這樣的習慣呢？下面我們就IntelliJ IDEA使用向大家介紹一下。
IDEA默認對Javadoc的支持非常不錯，但是這里我們要引入一個插件，那就是JavaDoc Sync Plugin，這兩者的結(jié)合將非常完美：JavaDoc Sync Plugin會提示你添加javadoc注釋及注釋同步，而IDEA本身會校驗javadoc語法，這樣我們的工作就會簡單很多。
首先打開Plugin Manager下載并安裝JavaDoc Sync Plugin，重啟IDEA后在設(shè)置面板中選擇“Errors”選項，在“Errors”對話框中的文本過濾欄輸入javadoc，如下圖。這時就會出現(xiàn)和javadoc相關(guān)的設(shè)置選項：
|
這里我們想對這些設(shè)置項進行說明：
- Declaration has javadoc problem：這個設(shè)置項主要是校驗javadoc的語法錯誤，如不必要的javadoc注釋，必需的tag丟失等等。這個設(shè)置項有很多的參數(shù)設(shè)定，你可以參考一下；
- Inconsistent Javadoc主要檢測javadoc注釋沖突，如接口和實行類的javadoc不一致；
- Missing Class Javadoc delcaration等提示你應該添加注釋。
- Severity最右邊的小按鈕可以設(shè)置錯誤級別顯示效果。
有了這些配置，相信你不在會忘記添加javadoc注釋啦，因為IDEA會實時地給你指出來（高亮、背景等），這是IDEA的代碼審查特性。IDEA同時提供了快速添加和糾錯注釋功能，只需一個鍵盤操作，就可以完成注釋添加、同步和糾錯。
|
|
總結(jié)：通過以上設(shè)置，相信每一個人都會養(yǎng)成編寫Javadoc的好習慣，格式統(tǒng)一。如在版本控制系統(tǒng)管理下，java類的注釋需要@author和@version tag，這樣每個人都會加上，對管理代碼有很大的幫助。IDEA同時允許你給不同的錯誤級別設(shè)置不同的顯示效果，這樣你文檔中各種問題進行標識，方便管理。
|