引言
在 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!