在 Android 开发中，用户交互是构建优秀应用的核心。而在众多交互组件中，警告对话框 无疑是最常用且最直观的一种。我们经常遇到这样的场景：需要用户在执行关键操作前做出确认，或者从一组有限的选项中做出决定。
虽然标准的“确认/取消”对话框非常常见，但在本篇文章中，我们将深入探讨一种更具交互性的变体：带有单项选择的警告对话框。这种对话框允许我们在一个弹出的浮层中直接展示一个列表，用户只需轻轻一点即可选中其中一个选项，无需跳转到新的页面，极大地提升了用户体验的连贯性。
我们将一起通过构建一个完整的项目，从零开始学习如何使用 Java 和 Kotlin 实现这一功能。这不仅仅会涉及到 AlertDialog 的基本使用，在 2026 年的今天，我们更要结合 Material You 设计规范 和 AI 辅助开发 的最新理念来审视这个经典的组件。准备好了吗？让我们开始吧。
目录
项目准备：创建现代化的 Android 项目
在开始编写代码之前，我们需要一个干净的项目环境。如果你还没有创建项目，可以按照以下步骤操作。值得注意的是，现在的开发环境已经高度智能化，我们建议使用最新的 Android Studio Koala 或更高版本，并启用 AI 辅助功能。
- 打开 Android Studio。
- 选择 New Project。
- 选择 Empty Views Activity（确保选择该模板以获得最简洁的起始代码）。
- 配置你的项目：
* Name: SingleChoiceDialogDemo
* Language: Kotlin（强烈推荐，或者 Java）
* Minimum SDK: API 24: Android 7.0 或更高。
第一步：构建用户界面 (UI)
首先，我们需要一个简单的界面来触发我们的对话框。为了展示效果，我们设计了一个包含两个主要元素的布局。考虑到 2026 年的设计趋势，我们将确保布局不仅功能完善，还要符合无障碍标准。
编写 XML 布局文件
请打开 INLINECODE88893183 文件。我们将使用 INLINECODE9fa7fb0a 作为根布局，因为它能够灵活地控制控件位置，并且是现代 Android 开发的标准。
下面是完整的 XML 代码。为了方便你理解，我在代码中添加了详细的注释，解释了每个属性的作用：
第二步：2026 视角下的核心逻辑与 Material Design 3
在 2026 年，我们不再仅仅依赖原生的 INLINECODE9f04f689。为了获得符合 Material You (Material Design 3) 规范的圆角、色彩和动效，我们强烈建议使用 INLINECODEce31e66b。这不仅是代码的升级，更是对用户体验的尊重。
核心 API：setSingleChoiceItems 的现代化演进
这个方法依然是实现单项选择的关键，但在现代开发中，我们需要结合 RecyclerView 的思想来理解它的性能优化。
// 引入 Material Components 库中的 Builder
import com.google.android.material.dialog.MaterialAlertDialogBuilder
// ... 在 Activity 中 ...
val items = arrayOf("仅 Wi-Fi 下下载", "始终下载", "永不下载")
var checkedItem = 0 // 默认选中第一项
val builder = MaterialAlertDialogBuilder(this, R.style.ThemeOverlay_App_MaterialAlertDialog) // 自定义主题
builder.setTitle("网络设置")
.setSingleChoiceItems(items, checkedItem) { dialog, which ->
checkedItem = which // 更新选中索引
// 实时反馈逻辑...
}
.setPositiveButton("确认") { dialog, which ->
// 提交逻辑
}
参数深度解析与 2026 新考量
- INLINECODEc0f26334: 在数据量较小时，数组没问题。但如果我们在构建一个大型设置面板，推荐使用 INLINECODEf13dd3a8 结合自定义 View 的形式。INLINECODE4ae16b51 内部其实也是使用了 INLINECODE32149c6d，Android 系统会自动处理回收和复用，这一点你大可放心。
- INLINECODEc3fd4835: 这是一个整数。在处理“未选中”状态时，依然传入 INLINECODE6fd6aa64。但在 2026 年，考虑到数据持久化，这个值通常不应存放在内存中，而应该结合
DataStore来读取默认值。
-
onClick Listener: 现在的 Lambda 表达式让代码非常简洁。但要注意的是，在这个回调中不要执行耗时操作，比如写入大文件，这会导致对话框卡顿。始终保持 UI 线程的轻量级。
第三步：实现 MainActivity 逻辑
现在，让我们把理论付诸实践。我们将展示如何处理按钮的点击事件，构建对话框，并优雅地处理用户的选择结果。这里我们采用了 MVVM (Model-View-ViewModel) 的简化思想，将逻辑尽量从 Activity 中剥离，这是现代 Android 开发的最佳实践。
Kotlin 完整实现 (推荐)
Kotlin 的语法非常简洁，特别是使用了 Lambda 表达式后。请看下面的代码，它是如何优雅地处理这个需求的：
package org.geeksforgeeks.demo
import android.os.Bundle
import android.widget.Button
import android.widget.TextView
import androidx.appcompat.app.AppCompatActivity
import com.google.android.material.dialog.MaterialAlertDialogBuilder
class MainActivity : AppCompatActivity() {
private lateinit var bOpenAlertDialog: Button
private lateinit var tvSelectedItemPreview: TextView
// 使用 DataStore 或 ViewModel 管理这个状态会更好，这里为了演示简化处理
private var selectedItemIndex = 0
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
// 初始化视图
bOpenAlertDialog = findViewById(R.id.openAlertDialogButton)
tvSelectedItemPreview = findViewById(R.id.selectedItemPreview)
// 初始化 UI 状态
updatePreviewText(selectedItemIndex)
// 为按钮设置点击监听器
bOpenAlertDialog.setOnClickListener {
showMaterialDialog()
}
}
private fun showMaterialDialog() {
// 准备列表数据 - 模拟配置选项
val items = arrayOf("高性能模式", "均衡模式", "省电模式")
// 2026 开发建议：始终使用 MaterialAlertDialogBuilder
val builder = MaterialAlertDialogBuilder(this)
builder.setTitle("选择电源管理模式")
builder.setSingleChoiceItems(items, selectedItemIndex) { dialog, which ->
// 更新选中项的索引
selectedItemIndex = which
// 这里的交互设计：是立即生效还是点击确定后生效？
// 这里我们演示立即更新 UI，但不关闭对话框，让用户确认
tvSelectedItemPreview.text = "当前选择: ${items[which]}"
}
builder.setPositiveButton("应用设置") { dialog, _ ->
// 这里通常调用 ViewModel 的方法来保存配置
dialog.dismiss()
}
builder.setNegativeButton("取消") { dialog, _ ->
// 取消时，可能需要回滚 UI 变化（如果之前做了即时预览）
updatePreviewText(selectedItemIndex)
dialog.dismiss()
}
val alertDialog = builder.create()
alertDialog.show()
}
private fun updatePreviewText(index: Int) {
val modes = arrayOf("高性能模式", "均衡模式", "省电模式")
if (index >= 0 && index < modes.size) {
tvSelectedItemPreview.text = "当前选择: ${modes[index]}"
}
}
}
Java 实现代码
对于 Java 用户，逻辑是完全一致的，只是语法略显冗长。这是经典的面向对象写法，非常清晰：
package org.geeksforgeeks.demo;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.TextView;
import androidx.appcompat.app.AppCompatActivity;
import com.google.android.material.dialog.MaterialAlertDialogBuilder;
public class MainActivity extends AppCompatActivity {
private Button bOpenAlertDialog;
private TextView tvSelectedItemPreview;
private int selectedItemIndex = 0; // 默认选中第一项
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
bOpenAlertDialog = findViewById(R.id.openAlertDialogButton);
tvSelectedItemPreview = findViewById(R.id.selectedItemPreview);
bOpenAlertDialog.setOnClickListener(v -> showDialog());
}
private void showDialog() {
final String[] listItems = new String[]{"高性能模式", "均衡模式", "省电模式"};
// 使用 Material 版本的 Builder
MaterialAlertDialogBuilder builder = new MaterialAlertDialogBuilder(this);
builder.setTitle("选择电源管理模式");
builder.setSingleChoiceItems(listItems, selectedItemIndex, (dialog, which) -> {
selectedItemIndex = which;
tvSelectedItemPreview.setText("当前选择: " + listItems[which]);
});
builder.setPositiveButton("应用设置", (dialog, which) -> dialog.dismiss());
builder.setNegativeButton("取消", (dialog, which) -> dialog.dismiss());
builder.show();
}
}
进阶探讨：2026 开发者的工具箱与最佳实践
现在我们已经掌握了基本的实现方法。但在实际的生产环境中，仅仅“显示出来”往往是不够的。作为一名追求卓越的开发者，我们需要结合最新的技术趋势来优化我们的代码。
1. AI 赋能开发：从编码到 Copilot
在 2026 年，我们不再孤军奋战。在使用 setSingleChoiceItems 这类 API 时，我们可能会遇到复杂的业务逻辑，比如列表项需要根据用户权限动态显示。
这时，我们可以利用 Cursor AI 或 GitHub Copilot 作为我们的结对编程伙伴。
- 场景：你需要从远程 API 获取选项列表，并将其显示在 Dialog 中。
- AI 辅助实践：我们可以直接向 AI 提问：“使用 Kotlin 协程和 Retrofit 获取配置列表，并使用 MaterialAlertDialogBuilder 展示单项选择，如何在网络请求失败时展示重试选项？”
- 思考：AI 不仅能生成代码，还能帮助我们处理边界情况。例如，AI 会提醒我们，在对话框打开前必须检查 INLINECODE481ee8b9 是否存活，否则会引发 INLINECODE9d23b24c。这种由 AI 驱动的防御性编程，是现代开发的重要组成部分。
2. 深度状态管理与生命周期感知
你可能会遇到这样的情况：用户打开了对话框，然后旋转了屏幕。如果不做处理，对话框会消失，用户的输入也会丢失。这是 Android 开发中的经典痛点。
我们可以通过 INLINECODE8f9c92f7 和 INLINECODEf264718a 来彻底解决这个问题。让我们看一段更高级的代码片段，展示了如何实现“在屏幕旋转后，对话框依然保持打开状态且选中项不变”：
// ViewModel 代码片段
class DialogViewModel : ViewModel() {
// 使用 SavedStateHandle 保存配置项，即便进程重启也能恢复
val selectedOption = MutableStateFlow(0)
val isDialogShowing = MutableStateFlow(false)
}
// 在 Activity 中监听状态
viewModel.isDialogShowing.collectWithLifecycle(this) {
if (it && !supportFragmentManager.isStateSaved) {
showMaterialDialog() // 重新显示对话框
}
}
3. 性能优化：从本地到云端
我们现在的列表是硬编码在代码中的字符串数组。但在现代应用中，数据往往来源于网络。
- 策略：不要在 UI 线程构建列表。使用 Kotlin 的 INLINECODE2258baa9 或 Java 的 INLINECODEa63bf550 来监听数据变化。当数据更新时，先关闭当前对话框，然后提示用户“选项已更新”，或者仅在下一次打开时生效。
- 监控：利用 Firebase Performance 或各种可观测性工具，监控 INLINECODEf31ce046 的构建耗时。如果 INLINECODE90b840b9 传入的数据量过大（虽然不推荐在 Dialog 中显示海量数据），可能会导致主线程卡顿。我们会将数据列表限制在合理范围内（例如少于 20 项），超过则跳转至专门的列表页面。
4. 用户体验：Vibe Coding 与 氛围感
在 2026 年，应用不仅要好用，还要有“氛围感”。Material Design 3 强调动态色彩。
我们可以利用 MaterialAlertDialogBuilder 的构造函数传入自定义主题，让 Dialog 的颜色直接取自用户设置的壁纸色。
// 这种写法让你的 Dialog 与系统主题完美融合
val builder = MaterialAlertDialogBuilder(
context,
R.style.ThemeOverlay_Material3_MaterialAlertDialog_Centered
)
这不仅仅是一行代码，这是对用户个性化选择的尊重。
总结与替代方案
通过这篇文章，我们不仅仅学习了一个 API 的调用，更完整地构建了一个符合 2026 年技术标准的交互模块。从 XML 布局的设计，到 Kotlin/Java 逻辑的实现，再到 ViewModel 状态保存和 Material Design 3 的视觉优化，以及 AI 辅助开发的思考，这些都是成为一名高级 Android 工程师必经的积累。
然而，我们也需要思考：单项选择 Dialog 永远是最佳方案吗？
在现代移动端设计中，我们极力推崇 Bottom Sheets (底部抽屉)。对于大屏手机或折叠屏设备，底部抽屉比位于屏幕中央的 Dialog 更易于拇指触控。如果你的选项列表超过 5 项，或者选项文本较长，强烈建议使用 ModalBottomSheet 替代 Dialog。这也是 GeeksforGeeks 希望传达的深层技术理念：没有银弹，只有最合适的解决方案。
希望这篇文章能为你的开发之路提供有力的帮助！