Eclipse 編譯錯誤「Syntax error on token package」排查：編碼格式惹的禍

Eclipse 編譯錯誤「Syntax error on token package」排查：編碼格式惹的禍

專案 Clean 後突現離譜錯誤：Syntax error on token "package", assert expected。代碼語法無誤、包聲明在首行、Import 順序正確、括號匹配完美——一切常規檢查全通過，卻依然報錯。

根因定位

專案導入時未指定編碼，工作空間預設為 GBK，而源文件實為 UTF-8。編譯器讀取到位元組序列與預期字符不匹配，導致詞法分析階段產生莫名其妙的 Token 錯誤。

解決步驟

1. 右鍵專案 → Properties → Resource → Text file encoding → 選 UTF-8
2. 或修改 .settings/org.eclipse.core.resources.prefs：encoding=UTF-8
3. 專案 Clean → Build Automatically，錯誤即刻消失

避坑指南

• 團隊統一制定 UTF-8 為唯一編碼標準，寫入 .gitattributes 或 editorconfig
• Maven/Gradle 專案在 pom.xml/build.gradle 顯式聲明 encoding = 'UTF-8'
• 遇到「不可能的語法錯誤」、「中文亂碼」、「莫名 Token 錯誤」→ 第一時間查編碼

編碼問題不顯山露水，但能讓編譯器「發瘋」。養成「先看編碼，再看語法」的診斷直覺，能省下無數調試小時。