Eclipse 導出 Javadoc 報錯「未終止的內嵌標記」：@link 缺失右大括號

錯誤信息

錯誤: 未終止的內嵌標記
*/
^

問題代碼

/**
 * 設置需要識別的的身份證字段Mask
 * {@link #RECOGNIZE_FLAG_ALL}(default)
 * {@link #RECOGNIZE_FLAG_NAME}
 * ...
 * {@link #RECOGNIZE_FLAG_VALIDITY   // ← 此處缺少右大括號 }
 */

修正方法

在最後一個 @link 標記後補全 }：

{@link #RECOGNIZE_FLAG_VALIDITY}

避坑指南

• Javadoc 中 {@link ...}、{@code ...}、{@literal ...} 等內嵌標記**必須成對閉合**。
• 使用 IDE 自動補全（Alt+/ 或 Ctrl+Space）生成標記，減少手寫錯誤。
• 導出前先運行 Project > Generate Javadoc 並勾選「Only report errors」，快速定位語法問題。

補充說明

此錯誤屬於 Javadoc 解析階段錯誤，不影響代碼編譯運行，但會導致文檔生成失敗。養成編寫註釋時即時預覽（懸停查看）的習慣。