問題本質
雙系統 (如 Windows + Linux / Windows + macOS) 共享同一磁盤分區上的 Eclipse 工作空間或項目目錄，導致 JDK 路徑、版本、插件配置衝突。
核心衝突點對比
| 配置項 | Windows | Linux/macOS | 衝突後果 |
|---|
| JDK 安裝路徑 | `C:\Program Files\Java\jdk-17` | `/usr/lib/jvm/java-17-openjdk` | Eclipse `.metadata/.plugins/org.eclipse.jdt.core` 存儲絕對路徑，跨系統無效 |
| 文件路徑分隔符 | `\` | `/` | `.classpath` `.project` 中路徑引用失效 |
| 插件安裝目錄 | Eclipse 安裝目錄下 | 同上 | 插件版本/原生庫不兼容 |
| 行尾結束符 | CRLF | LF | Git diff 噪音、編譯器警告 |
解決方案 (按推薦程度)
方案一：完全隔離工作空間 (最穩健) ⭐⭐⭐⭐⭐
- 每個系統使用獨立的 Eclipse 安裝目錄和獨立的工作空間目錄
- 項目代碼通過 Git 同步 (推薦 GitHub/GitLab/Gitee 私有倉庫)
- 優點：零配置衝突、獨立升級、原生性能
方案二：統一使用構建工具 + 導入項目 (標準化) ⭐⭐⭐⭐
- 項目採用 Maven/Gradle 管理依賴與構建
- 各系統安裝對應 JDK (版本一致，如統一 JDK 17)
- Eclipse 通過
File > Import > Maven > Existing Maven Projects 導入
- Eclipse 僅作編輯器，構建/運行交給命令行 `mvn compile` / `gradle build`
方案三：便攜式 Eclipse + 相對路徑 (折中) ⭐⭐⭐
- 使用 Eclipse Installer 安裝到可移動硬盤/共享分區
- 啟動參數指定工作空間：`eclipse -data /shared/workspace`
- 項目 `.classpath` 使用類路徑變量而非絕對路徑：
- JDK 在兩系統安裝在相同相對路徑 (如 `/opt/java/jdk-17` 和 `D:\Java\jdk-17` 映射)
方案四：容器化開發環境 (現代化) ⭐⭐⭐⭐
# .devcontainer/Dockerfile
FROM eclipse-temurin:17-jdk
RUN apt-get update && apt-get install -y maven git
WORKDIR /workspace
# VS Code Remote Containers / GitHub Codespaces / JetBrains Gateway 直接連接
優點：環境 100% 一致、無本地污染、雲端同步。
快速診斷步驟
- 在報錯系統打開終端：`java -version` / `javac -version` 確認 JDK 版本
- Eclipse: `Window > Preferences > Java > Installed JREs` 檢查是否指向正確 JDK
- 項目右鍵 `Properties > Java Build Path > Libraries` 檢查 JRE System Library
- 清理項目：`Project > Clean...` 勾選 "Delete project contents on disk (cannot be undone)" 重新構建
最佳實踐總結
- ✅ 代碼只放 Git 倉庫，不放共享文件夾/網盤
- ✅ 構建用 Maven/Gradle，IDE 只負責編輯/調試
- ✅ JDK 版本鎖定：項目根目錄 `.sdkmanrc` / `.tool-versions` / `pom.xml`
17
- ✅ 行尾統一 LF：Git 配置 `core.autocrlf=input`，編輯器設置 LF
- ✅ 避免共享 .metadata：`.gitignore` 忽略 `.metadata/` `.settings/` `bin/` `target/`
