Eclipse 導入同名專案報錯「already exist in workspace」解決方法

問題現象

將專案目錄從 iheida3 重命名為 iheida4 後導入 Eclipse，提示「Some projects cannot be imported because they already exist in the workspace」，但工作區中明顯沒有 iheida4 專案。

根本原因

Eclipse 識別專案身份依賴 .project 文件中的 <name> 標籤，而非目錄名稱。

驗證方法

<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
    <name>iheida3</name>  <!-- 這裡仍然是舊名稱 -->
    <comment></comment>
    <projects></projects>
    <buildSpec>...</buildSpec>
    <natures>...</natures>
</projectDescription>

解決步驟

1. 打開 iheida4 目錄下的 .project 文件
2. 將 <name>iheida3</name> 修改為 <name>iheida4</name>
3. 保存文件
4. 在 Eclipse 中重新導入：File → Import → General → Existing Projects into Workspace
5. 選擇 iheida4 目錄，勾選「Copy projects into workspace」（可選）

進階說明

• .classpath 文件通常不需要修改，除非包含絕對路徑引用
• 若使用 Maven/Gradle，建議執行 mvn eclipse:eclipse 或 gradle eclipse 重新生成配置
• Git 版本控制下，.project 和 .classpath 建議加入版本管理

避坑指南

複製專案時，務必修改 .project 中的 name，而不只是重命名目錄。這是 Eclipse 元數據機制的基本常識。