Eclipse 修改套件名稱完整操作指南（含 src、gen、專案名稱）

Android 或 Java 專案重構時，修改套件名稱是高風險操作：改錯或遺漏會導致大量編譯錯誤、資源找不到、Manifest 不匹配。本文提供 Eclipse 官方重構工具的標準流程，確保一致性修改並自動更新所有引用。

前置準備：備份專案

務必先備份整個專案資料夾（複製備份或 Git commit），重構失敗可秒級回滾。

步驟一：修改原始碼套件名稱

1. 在 Package Explorer 中展開 src 目錄
2. 右鍵點擊目標套件（如 com.old.package） → Refactor → Rename (或按 F2)
3. 輸入新套件名稱（如 com.new.package）
4. 關鍵：勾選所有四個選項：
   • ✅ Update references
   • ✅ Rename subpackages
   • ✅ Rename qualifying references
   • ✅ Rename in comments and strings (視需求)
5. 點擊 Preview → 檢查異動清單 → Continue → OK
6. 等待重構完成，Console 顯示 Refactoring completed

步驟二：修改 gen 目錄下套件名稱

gen 目錄由建構工具自動產生（R.java、BuildConfig.java 等），不需手動修改。完成步驟一後，執行 Project → Clean 重新建構，gen 會自動依新套件名稱重新生成。

若仍殘留舊套件：手動刪除 gen 整個資料夾 → Project → Clean → 重建。

步驟三：修改 AndroidManifest.xml 套件屬性

Android 專案必須同步修改 Manifest：

<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="com.new.package" >  <!-- 這裡必須與新套件名一致 -->
    ...
</manifest>

若使用 Gradle，同時檢查 build.gradle 的 namespace 或 applicationId 設定。

步驟四：（可選）修改 Eclipse 專案顯示名稱

1. 右鍵專案根節點 → Refactor → Rename
2. 輸入新專案名稱
3. 此操作僅改變 Eclipse 工作區顯示名稱，不會修改實體資料夾名稱

步驟五：清理與驗證

1. 選單 Project → Clean... → 勾選所有專案 → Clean
2. 檢查 Problems 視圖，確認無紅色錯誤
3. 執行專案驗證啟動、建構 APK、單元測試

常見遺漏檢查清單

進階：命令列批次重構

大型專案可使用 sed 或 IDE 無頭模式批次處理，但強烈建議配合版控系統分支操作，逐步驗證。

遵循「備份 → 重構 src → Clean 重建 gen → 同步 Manifest/Gradle → 全專案 Clean → 驗證」流程，即可安全完成套件名稱變更，避免「改完專案跑不起來」的災難。