Android 專案剛建立報錯：AppCompat v7 包缺失或版本不匹配解決方案

常見錯誤現象

初學者配置好 Android 開發環境（Eclipse + ADT 或早期 Android Studio）後，新建專案即報錯，錯誤提示多與 android.support.v7.appcompat 相關，例如：

• 找不到資源 @style/Theme.AppCompat
• 建議建立 ActionBarActivity（已過時）
• 專案結構中 v7 包顯示紅叉

根本原因

Android Support Library v7 包未正確下載、版本與 compileSdkVersion 不匹配、或本地 Maven 庫損壞。 早期 Eclipse ADT 時代，v7 包需作為 Library Project 手動導入；Android Studio 則透過 Gradle 依賴管理，若離線模式或鏡像源不可用會導致下載失敗。

解決步驟

方案一：使用 SDK Manager 重新下載/更新 Support Repository

1. 打開 SDK Manager
2. 勾選 Android Support Repository、Android Support Library（舊版）
3. 點擊 Install packages 完成下載
4. 重啟 IDE，Clean Project

方案二：Android Studio 修正 Gradle 依賴 (現代專案)

// build.gradle (Module: app)
dependencies {
    implementation 'androidx.appcompat:appcompat:1.6.1' // 推薦遷移至 AndroidX
    // 舊版支援庫寫法（不再維護）
    // implementation 'com.android.support:appcompat-v7:28.0.0'
}

確保 compileSdkVersion 與支援庫主版本一致（如均為 33 或 34）。

方案三：Eclipse ADT 手動導入 v7 Library Project (舊專案維護)

1. File → Import → Existing Android Code Into Workspace
2. 選擇 <sdk>/extras/android/support/v7/appcompat
3. 專案右鍵 Properties → Android → Library → Add 選擇剛導入的 appcompat

避坑指南

• 新專案請直接使用 AndroidX (androidx.appcompat:appcompat)，官方已停止更新 Support Library
• 中國大陸開發者建議配置 阿里雲/騰訊雲 Maven 鏡像 加速依賴下載
• 遇到「資源找不到」先嘗試 Build → Clean Project 再 Rebuild

掌握依賴管理機制，能讓你從「環境配置地獄」中解脫，專注於業務邏輯開發。