Eclipse 最新版使用避坑指南：SDK 下載、v7 兼容、v21 報錯、圖標缺失、R 文件、預覽失效

Eclipse 開發 Android 遇到的 6 大高頻問題及解決方案，涵蓋 SDK 下載加速、Support v7 包缺失、v21 風格報錯、圖標路徑錯誤、R 文件生成失敗、佈局預覽版本不匹配，助你快速恢復開發效率。

1. SDK 下載極慢

解決：設置 HTTP/HTTPS 代理指向國內鏡像（如 `mirrors.neusoft.edu.cn:80`），優先下載 API 20-24，避免後續缺包報錯。

2. Support-v7 包找不到

現象：Error retrieving parent for item: No resource found that matches the given name 'Theme.AppCompat.Light.DarkActionBar'

解決：右鍵項目 → Android Tools → Add Support Library... → 按提示下載安裝。隨後導入 v7 庫項目並添加 JAR 引用。

3. v21 風格資源報錯

現象：No resource found that matches the given name 'android:Widget.Material.ActionButton'

解決：修改 v7 庫項目下 project.properties 的 target 版本為 21+（如 `target=android-22`），使其能訪問 Material 風格資源。

4. 找不到啟動圖標

現象：No resource found that matches the given name (at 'icon' with value '@drawable/ic_launcher')

原因：新版 ADT 將圖標放在 mipmap-* 目錄，而清單文件引用 @drawable/ic_launcher。

解決：修改 AndroidManifest.xml 圖標路徑為 @mipmap/ic_launcher，或將圖標複製到 drawable 目錄。

5. R 文件找不到資源

現象：activity_main cannot be resolved or is not a field

解決：刪除頂部錯誤導入 import android.R;，保留項目包下的 R 類。必要時 Project → Clean 重新構建。

6. 佈局預覽失效

現象：This version of the rendering library is more recent than your version of ADT plug-in

原因：SDK 版本過高，ADT 插件版本過低，渲染庫不兼容。

解決：降低 SDK 版本（如用 API 22 替代 23），或更新 ADT 插件（Help → Check for Updates）。

總結檢查清單

• [ ] SDK 代理已配置，核心 API 已下載
• [ ] Support Library 已通過 Android Tools 安裝
• [ ] v7 項目 target 版本 ≥ 21
• [ ] Manifest 圖標引用 @mipmap/ic_launcher
• [ ] 無錯誤導入 android.R
• [ ] SDK/ADT 版本匹配，預覽正常

逐項排查，多數環境問題 10 分鐘內可解決。