引言
在 Android 開發的日常迭代中，我們經常需要升級或降級項目的 minSdkVersion、targetSdkVersion 與 compileSdkVersion。升級可以解鎖新特性和性能優化；降級則可能為了兼容舊機型或快速驗證問題。本文將手把手演示在 Android Studio 里修改 Android 版本的兩種主流做法，并給出易踩的坑與最佳實踐，幫助你少踩雷、一次過。

---

一、先厘清三個關鍵字段

字段名	作用簡述	常見誤區
compileSdkVersion	項目編譯時使用的 SDK 版本，決定你能調用哪些新 API。	并非越高越好，需與 Gradle 插件、依賴庫匹配。
minSdkVersion	應用最低可安裝的 Android 版本。	設太低會導致新 API 不可用，設太高會丟失大量用戶。
targetSdkVersion	聲明“我已經在該版本上充分測試”，影響系統兼容性策略。	必須 ≤ compileSdkVersion，且建議隨 Google Play 要求逐年升級。

---

二、方法一：圖形化操作（適合新手）

1. 打開項目后，依次點擊菜單欄：File → Project Structure（或快捷鍵 Ctrl+Alt+Shift+S）。
2. 在左側選擇 Modules → app → Properties 選項卡。
3. 直接在下拉框里選擇需要的版本：
   • Compile Sdk Version：例如 34（Android 14）。
   • Min Sdk Version：例如 24（Android 7.0）。
   • Target Sdk Version：例如 34（與 Compile 同級或更低）。
4. 點擊 Apply → OK，Android Studio 會自動觸發 Gradle Sync。
5. 同步完成后，Rebuild Project（Build → Rebuild Project）驗證無報錯即可。

三、方法二：直接改 build.gradle.kts（推薦進階）
打開模塊級構建腳本（app/build.gradle.kts 或 app/build.gradle），找到 android {} 區塊：

android {compileSdk = 34defaultConfig {applicationId = "com.example.myapp"minSdk = 24targetSdk = 34versionCode = 1versionName = "1.0"}// ... 其他配置
}

修改后按 Ctrl+S 保存，頂部會出現 “Sync Now” 提示，點擊即可。
如果你喜歡命令行，也可以在終端執行：

./gradlew assembleDebug

---

四、常見報錯與排查清單

現象	可能原因	解決思路
Unresolved reference: Build.VERSION_CODES.TIRAMISU	compileSdk 低于 33	把 compileSdk 升到 33 及以上。
真機安裝失敗 INSTALL_FAILED_OLDER_SDK	minSdk 高于設備系統版本	降低 minSdk 或在 gradle 中啟用 abiFilters 分包。
同步時報 Could not find com.android.tools.build:gradle:X.Y.Z	Gradle 插件版本與 compileSdk 不匹配	打開 gradle/libs.versions.toml 或 project-level build.gradle，升級 com.android.tools.build:gradle 至對應版本。

---

五、最佳實踐小結

1. 年度例行升級：Google Play 每年 8 月左右會提高 targetSdkVersion 的強制要求，建議提前 1~2 個季度完成適配。
2. Lint 檢查：在 Android Studio 中運行 Analyze → Inspect Code，可快速發現高版本 API 在低版本系統上的調用風險。
3. 多模塊項目：若存在 library 模塊，需確保所有模塊的 minSdk ≤ app 模塊的 minSdk，否則合并時會報錯。
4. 版本對照表：收藏官方 API Levels 頁面，隨時查代號與版本號。

---

結語
修改 Android 版本只是“改三行數字”那么簡單，卻牽一發動全身：API 兼容性、依賴庫、Google Play 政策、用戶覆蓋率都會隨之變化。希望本文的兩種方法 + 避坑清單能讓你下次升級時胸有成竹。Happy Coding!