eclipse 添加註釋

I. 如何自動添加註釋

可經過以下三種方法自動添加註釋：
1. 輸入「/**」並回車。
2. 用快捷鍵 Alt＋Shift+J。
3. 在右鍵菜單中選擇「Source > Generate Element Comment」。

II. 如何自定義註釋格式

經過菜單 Window->Preference 打開參數設置面板，而後選擇：
Java -> Code Style -> Code Templates

在右側選擇Comments,將其中的Files項，而後選右邊的"Edit"，進入編輯模式：   

進入編輯模式後就能夠自定義註釋了。另外能夠插入一些變量，如年、日期等等。

最後，確保 Code -> New Java files 中有："${filecomment}"

III. 導入/導出代碼格式模板

經過「導出」和「導入」功能，你能夠把本身的模板導出來在其餘機器上使用。

操做步驟:打開Window->Preferences->Java->Code Style->Code Templates

如圖：

 

 

點擊「Import」，導入模板codetemplates.xml文件。

 

附：codetemplates.xml文件內容

<?xml version= "1.0"  encoding= "UTF-8"  standalone= "no" ?><templates><template autoinsert= "false"  context= "filecomment_context"  deleted= "false"  description= "Comment for created Java files"  enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.filecomment"  name= "filecomment" > /**   * <b>項目名：</b>系統項目名稱<br/>   * <b>包名：</b>${package_name}<br/>   * <b>文件名：</b>${file_name}<br/>   * <b>版本信息：</b><br/>   * <b>日期：</b>${date}-${time}<br/>   * <b>Copyright (c)</b> ${year}XX公司-版權全部<br/>   *   */ </template><template autoinsert= "true"  context= "filecomment_context"  deleted= "false"  description= "Comment for created JavaScript files"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.filecomment"  name= "filecomment" > /**   *   */ </template><template autoinsert= "true"  context= "delegatecomment_context"  deleted= "false"  description= "Comment for delegate functions"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.delegatecomment"  name= "delegatecomment" > /**   * ${tags}   * ${see_to_target}   */ </template><template autoinsert= "false"  context= "typecomment_context"  deleted= "false"  description= "Comment for created types"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.typecomment"  name= "typecomment" > /**   * @author kin   *   * ${tags}   */ </template><template autoinsert= "false"  context= "typecomment_context"  deleted= "false"  description= "Comment for created types"  enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.typecomment"  name= "typecomment" > /**   *   * <b>類名稱：</b>${type_name}<br/>   * <b>類描述：</b><br/>   * <b>建立人：</b>kin<br/>   * <b>修改人：</b>kin<br/>   * <b>修改時間：</b>${date} ${time}<br/>   * <b>修改備註：</b><br/>   * @version 1.0.0<br/>   *   */ </template><template autoinsert= "true"  context= "fieldcomment_context"  deleted= "false"  description= "Comment for vars"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.fieldcomment"  name= "fieldcomment" > /**   *   */ </template><template autoinsert= "false"  context= "constructorcomment_context"  deleted= "false"  description= "Comment for created constructors"  enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.constructorcomment"  name= "constructorcomment" > /**   * 建立一個新的實例 ${enclosing_type}.   *   * ${tags}   */ </template><template autoinsert= "true"  context= "overridecomment_context"  deleted= "false"  description= "Comment for overriding functions"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.overridecomment"  name= "overridecomment" > /* (non-Jsdoc)   * ${see_to_overridden}   */ </template><template autoinsert= "true"  context= "settercomment_context"  deleted= "false"  description= "Comment for setter method" enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.settercomment"  name= "settercomment" > /**   * @param ${param} the ${bare_field_name} to set   */ </template><template autoinsert= "true"  context= "settercomment_context"  deleted= "false"  description= "Comment for setter function"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.settercomment"  name= "settercomment" > /**   * @param ${param} the ${bare_field_name} to set   */ </template><template autoinsert= "false"  context= "gettercomment_context"  deleted= "false"  description= "Comment for getter method"  enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.gettercomment"  name= "gettercomment" > /**   * ${bare_field_name}   *   * @return  the ${bare_field_name}   * @since   1.0.0 */ </template><template autoinsert= "false"  context= "methodcomment_context"  deleted= "false"  description= "Comment for non-overriding methods"  enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.methodcomment"  name= "methodcomment" > /**   * ${enclosing_method}(這裏用一句話描述這個方法的做用)<br/>   * (這裏描述這個方法適用條件 – 可選)<br/>   * ${tags}   *${return_type}   * @exception   * @since  1.0.0 */ </template><template autoinsert= "true"  context= "delegatecomment_context"  deleted= "false"  description= "Comment for delegate methods"  enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.delegatecomment"  name= "delegatecomment" > /**   * ${tags}   * ${see_to_target}   */ </template><template autoinsert= "true"  context= "constructorcomment_context"  deleted= "false"  description= "Comment for created constructors"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.constructorcomment"  name= "constructorcomment" > /**   * ${tags}   */ </template><template autoinsert= "true"  context= "overridecomment_context"  deleted= "false"  description= "Comment for overriding methods"  enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.overridecomment"  name= "overridecomment" > /* (non-Javadoc)   * ${see_to_overridden}   */ </template><template autoinsert= "false"  context= "fieldcomment_context"  deleted= "false"  description= "Comment for fields"  enabled= "true"  id= "org.eclipse.jdt.ui.text.codetemplates.fieldcomment"  name= "fieldcomment" > /**   * ${field}:${todo}（用一句話描述這個變量表示什麼）   *   * @since 1.0.0   */ </template><template autoinsert= "true"  context= "gettercomment_context"  deleted= "false"  description= "Comment for getter function"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.gettercomment"  name= "gettercomment" > /**   * @return the ${bare_field_name}   */ </template><template autoinsert= "true"  context= "methodcomment_context"  deleted= "false"  description= "Comment for non-overriding function"  enabled= "true"  id= "org.eclipse.wst.jsdt.ui.text.codetemplates.methodcomment"  name= "methodcomment" > /**   * ${tags}   */ </template></templates>