ianhuang筆記THE ADVENTURER'S JOURNAL
知識世界・持續探索中

ADVENTURE JOURNAL · 探索筆記

Gradle 編碼排錯:JavaCompile 與 Javadoc

任務導覽 TABLE OF CONTENTS

以有效 build.gradle 取代空白範本,區分來源編碼與 Javadoc 語法錯誤。

適用:Gradle 8系Java plugin的Groovy DSL示例。既有專案先確認wrapper版本與對應JDK需求。

症狀與診斷

unmappable character for encoding x-windows-950 表示編譯器以該編碼解讀來源遇到不可對映字元。先確認來源真的以UTF-8儲存,再指定編譯編碼;不能把原Big5來源只標成UTF-8。

build.gradle可採:

plugins { id 'java' }

tasks.withType(JavaCompile).configureEach {
    options.encoding = 'UTF-8'
}
tasks.withType(Javadoc).configureEach {
    options.encoding = 'UTF-8'
    options.charSet = 'UTF-8'
    options.docEncoding = 'UTF-8'
}

Windows用gradlew.bat,其他平臺用./gradlew:

./gradlew --version
./gradlew clean compileJava compileTestJava javadoc --stacktrace

應先確認compileJava成功,再確認javadoc成功,輸出位於build/docs/javadoc。withType會包含對應型別的tasks,不必只列兩個任務名稱。

Javadoc 失敗不只編碼

先閱讀第一個錯誤的檔名與行號;無效HTML、缺少引數檔案或JDK doclint更嚴格也會失敗。修正註解的標籤與特殊字元,不先關掉整個Javadoc或忽略所有失敗。若依賴類別找不到,檢查source set與classpath。

options.encoding是輸入來源,charSet/docEncoding影響輸出的HTML編碼。Kotlin DSL寫法不同,不能把Groovy片段直接貼入build.gradle.kts。正式建置應使用repository的wrapper而非全域性未知版本Gradle,並維持IDE和CI的JDK一致。

參考資料

冒險者留言

comments powered by Disqus

搜尋筆記

輸入關鍵字,探索所有筆記。

ESC 關閉 · 搜尋標題、標籤與文章全文