在使用 Eclipse 開發 Java 專案時，經常需要將專案在不同電腦之間複製遷移。有時明明原始碼完全相同，將專案複製到另一台機器上卻會報一個奇怪的錯誤：「java compiler level does not match the version of the installed java project facet」。這到底是什麼原因？又該如何快速解決？
如下圖所示，Eclipse 的 Problems 視窗會顯示這個編譯器層級不匹配的錯誤：
這個錯誤的本質是：專案的 Java 編譯器版本設定 與 專案 Facet（面向）配置中的 Java 版本 不一致。當專案在不同環境間遷移時，Eclipse 的工作區設定、JRE 版本差異都可能導致這兩個版本設定脫節。
在檔案總管中找到專案所在目錄，進入 .settings 子目錄，用文字編輯器開啟 org.eclipse.wst.common.project.facet.core.xml 配置檔案：
修改標示部分的版本號，使其與專案實際的編譯器版本設定保持一致。
在 Eclipse 中查看專案實際使用的編譯器版本：
這個問題雖然看起來棘手，但解決起來其實很簡單。關鍵在於確保兩個地方的 Java 版本設定一致：一是專案的編譯器設定，二是 Facet 配置檔案中的版本宣告。建議在團隊協作時，將 .settings 目錄納入版本控制，或使用 Maven/Gradle 等建構工具管理專案配置，從源頭避免此類環境差異問題。
