Android Studio R 文件報錯：清理重建無效時的核彈級解決方案

現象

專案編譯報錯，`R` 文件紅字，`Clean Project` / `Rebuild Project` / `Invalidate Caches` 均無效。

根因

Gradle 緩存、AAPT2 編譯器狀態、或 SDK 構建工具版本不匹配導致 R 類生成失敗/損壞。 某種「髒狀態」卡在本地緩存中。

核彈級解決步驟（按成功率排序）

1. 刪除所有緩存目錄：

   # 項目根目錄下執行
   rm -rf .gradle
   rm -rf build
   rm -rf app/build
   # Windows PowerShell
   Remove-Item -Recurse -Force .gradle, build, app/build

2. 刪除全局 Gradle 緩存：

   # Linux/macOS
   rm -rf ~/.gradle/caches
   # Windows
   rmdir /s /q %USERPROFILE%\.gradle\caches

3. 檢查 `build.gradle` 配置**
：

android {
    compileSdkVersion 34
    buildToolsVersion "34.0.0" // 必須與 compileSdkVersion 大版本一致
    defaultConfig { ... }
}

4. 升級/降級 Android Gradle Plugin (AGP)**
：

// project/build.gradle
dependencies {
    classpath 'com.android.tools.build:gradle:8.2.0' // 或穩定版 7.4.2
}

5. 離線模式 → 線上模式**
：Settings → Gradle → 取消 `Offline work`，重新 Sync 下載依賴。
6. 最後大招：刪項目重新 Clone / 從 Zip 導入**
：排除 `.idea`、`.gradle`、本地配置差異。