Eclipse 生成 Javadoc 亂碼問題的快速解決方案

在使用 Eclipse 專案生成 Javadoc 文檔時，若原始碼檔案採用 UTF-8 編碼，輸出的文檔常會出現亂碼。這是因為 Javadoc 工具預設使用系統預設編碼而非 UTF-8 所致。

解決步驟

在 Eclipse 的「Generate Javadoc」精靈對話框中，前往第三步驟「Javadoc options」頁面，找到 Extra Javadoc options 輸入框，加入以下參數：

-encoding UTF-8

確認後繼續完成生成流程，輸出的 HTML 文檔即可正確顯示中文字符，徹底解決亂碼困擾。

原理說明

Javadoc 底層調用 javadoc 命令，該參數會傳遞給底層的 Doclet，指定讀取源檔與輸出文檔均使用 UTF-8 編碼，確保編碼一致性。