Android Studio 依賴版本衝突：buildToolsVersion 低於引用庫版本導致波浪線報錯

在 Android Studio 中添加新依賴後，編輯器出現紅色波浪線報錯，但專案實際可正常構建運行。這通常是 buildToolsVersion 版本過低，低於所引用庫要求的最低版本所致。

現象與原因

• 錯誤提示多為「Failed to resolve」或版本衝突警告。
• Gradle 構建成功，APK 可安裝運行，僅 IDE 靜態分析報錯。
• 根因：buildToolsVersion（如 23.0.1）低於依賴庫編譯時使用的版本（如 23.2.0）。

解決方案

android {
    compileSdkVersion 23
    buildToolsVersion "23.2.0"  // 升級至依賴庫要求的版本或更高
    // ...
}

注意事項

• 升級 buildToolsVersion 需在 SDK Manager 中先下載對應版本。
• 若不想升級，可忽略波浪線，不影響打包運行，僅影響 IDE 代碼提示與靜態檢查準確性。
• 長期維護專案建議統一升級至較新穩定版本（如 30.0.3），並同步更新 compileSdkVersion、targetSdkVersion。

最佳實踐

1. 在 gradle/wrapper/gradle-wrapper.properties 固定 Gradle 版本。
2. 使用 dependencies { implementation "com.android.tools.build:gradle:7.x.x" } 管理插件版本。
3. 定期執行 ./gradlew dependencyUpdates 檢查依賴更新。

版本管理是 Android 開發的基本功，建立統一版本變量、鎖定構建工具鏈，能避免 90% 的版本衝突問題。