Android AlertDialog对话框如何使用？从基础创建到高级实战的完整教程

AlertDialog是Android平台最经典的对话框组件，几乎每一个应用都会用到它。无论是退出登录的二次确认、删除操作的警示提示，还是选择列表项的场景，AlertDialog都能胜任。不过在实际项目中，不少人对它的理解停留在复制粘贴示例代码的层面，一旦遇到点击外部不消失、按钮监听失效、自定义布局控件空指针等问题就束手无策。这篇文章将系统梳理AlertDialog的创建方式、各类对话框的实现、以及使用中的常见坑点。

AlertDialog的核心机制与基本用法

AlertDialog并不是直接new出来的，通常需要借助内部的Builder类完成构建。Builder采用链式调用设计，可以依次设置标题、内容、按钮等属性，最后调用create()生成对话框实例，再调用show()展示。这种设计的好处是配置过程一目了然，避免了传统构造函数参数过多的问题。

先看一个最基础的例子，用Kotlin代码实现：

val builder = AlertDialog.Builder(this)
builder.setTitle("提示")
    .setMessage("确定要退出登录吗？")
    .setPositiveButton("确定") { dialog, which ->
        // 执行退出登录逻辑
        finish()
    }
    .setNegativeButton("取消") { dialog, which ->
        dialog.dismiss()
    }
val dialog = builder.create()
dialog.show()

这段代码展示了三个核心方法：setTitle设置标题，setMessage设置正文内容，setPositiveButton和setNegativeButton分别设置确定和取消按钮。AlertDialog还支持setNeutralButton设置中间按钮，三个按钮可以同时存在，系统会自动排列位置。需要注意的是，三个按钮各自只能设置一个，重复设置会被后者覆盖。

另外说明一点，从Android 5.0开始，官方推荐使用androidx.appcompat.app.AlertDialog代替系统自带的android.app.AlertDialog。AppCompat版本的对话框能够自动适配Material主题，在不同系统版本上表现更加统一。引入依赖的方式很简单，在build.gradle中添加：

dependencies {
    implementation 'androidx.appcompat:appcompat:1.6.1'
}

四种常用对话框类型的实战演示

除了基础的文本对话框，AlertDialog还内置了列表、单选、多选三种交互形态，覆盖了绝大多数选择类场景。

第一种是列表对话框，通过setItems方法传入字符串数组即可：

val fruits = arrayOf("苹果", "香蕉", "橙子", "西瓜")
AlertDialog.Builder(this)
    .setTitle("请选择水果")
    .setItems(fruits) { dialog, which ->
        Toast.makeText(this, "你选择了${fruits[which]}", Toast.LENGTH_SHORT).show()
    }
    .show()

回调参数中的which表示被点击项的索引，可以直接用来定位数据源中的元素。列表项被点击后对话框会自动关闭，如果不想让它关闭，需要在回调中重新调用show()，不过这种做法体验不佳，更推荐使用单选对话框。

第二种是单选对话框，使用setSingleChoiceItems，传入数据源、默认选中项和监听器：

var selected = 0
AlertDialog.Builder(this)
    .setTitle("选择性别")
    .setSingleChoiceItems(arrayOf("男", "女", "保密"), selected) { dialog, which ->
        selected = which
    }
    .setPositiveButton("确定") { dialog, _ ->
        Toast.makeText(this, "选中索引：$selected", Toast.LENGTH_SHORT).show()
    }
    .setNegativeButton("取消", null)
    .show()

与列表对话框不同，单选对话框点击选项时不会自动消失，用户需要再点击确定或取消按钮。这给了用户反悔的机会，是更合理的交互设计。

第三种是多选对话框，使用setMultiChoiceItems，回调中会额外返回一个布尔值表示勾选状态：

val items = arrayOf("篮球", "足球", "羽毛球", "乒乓球")
val checked = booleanArrayOf(true, false, true, false)
AlertDialog.Builder(this)
    .setTitle("选择爱好")
    .setMultiChoiceItems(items, checked) { _, which, isChecked ->
        checked[which] =isChecked
    }
    .setPositiveButton("确定") { _, _ ->
        val result = items.filterIndexed { index, _ -> checked[index] }
        Toast.makeText(this, "选中：$result", Toast.LENGTH_SHORT).show()
    }
    .show()

第四种是自定义视图对话框，这也是实际项目中最常用的方式。当内置的布局无法满足需求时，可以通过setView加载自己的布局文件。这里有一个新手极易踩的坑：获取布局中控件引用时，必须使用对话框自己的window对象去findViewById，而不是Activity的findViewById，否则会抛出空指针异常：

val view = layoutInflater.inflate(R.layout.dialog_login, null)
val dialog = AlertDialog.Builder(this)
    .setTitle("用户登录")
    .setView(view)
    .setPositiveButton("登录") { d, _ -> d.dismiss() }
    .create()
dialog.show()
// 关键：从 dialog 的 window 中查找控件
val etName = dialog.window?.findViewById<android.widget.EditText>(R.id.etName)
etName?.setText("默认用户名")

常见问题与注意事项详解

第一个常见问题是点击对话框外部区域无法关闭。这个行为由setCanceledOnTouchOutside控制，默认值为true，也就是点击外部会关闭对话框。有些场景比如强制用户做出选择的弹窗，需要显式设置为false：

val dialog = AlertDialog.Builder(this)
    .setMessage("必须阅读并同意协议")
    .setPositiveButton("同意") { d, _ -> d.dismiss() }
    .create()
dialog.setCanceledOnTouchOutside(false)
dialog.setCancelable(false) // 同时禁止返回键关闭
dialog.show()

setCancelable(false)会同时屏蔽返回键和外部点击两种关闭方式，适合强确认场景。但要注意别滥用，用户被强制困在弹窗里的体验非常糟糕，可能直接导致差评。

第二个问题是dismiss()和cancel()的区别。两者都会关闭对话框，区别在于触发路径：cancel()是通过取消行为（按返回键、点击外部）关闭时会调用的方法，会触发setOnCancelListener设置的监听器；而dismiss()触发的是setOnDismissListener监听器。取消操作最终也会调用dismiss，所以OnDismissListener在任何关闭场景下都会被回调。如果需要在用户主动取消时做特殊处理，就用cancel相关回调；只想在对话框消失时清理资源，用dismiss回调即可。

第三个问题是内存泄漏。AlertDialog持有Context引用，如果在Activity已经销毁后才调用show()，会抛出WindowManager.BadTokenException异常并导致应用崩溃。正确的做法是在展示前判断Activity状态：

if (!isFinishing && !isDestroyed) {
    alertDialog.show()
}

同时，如果对话框内部有异步任务（比如网络请求完成后更新弹窗内容），务必在Activity的onDestroy中调用dialog.dismiss()，避免对话框长期持有已销毁的Activity。也可以考虑使用DialogFragment来包装AlertDialog，它能跟随生命周期自动管理对话框的创建与销毁，还能在屏幕旋转等配置变更时自动恢复状态，是官方更推荐的方案。

第四个问题是按钮点击事件不生效。最常见的原因是给setPositiveButton传了null，系统会认为不需要监听器，点击后只执行默认的关闭行为。另一种情况是自定义布局中的按钮被setView的布局遮挡，可以检查布局层级。此外，如果想阻止点击确定后自动关闭对话框（比如表单校验不通过时不允许关闭），不能在监听器里做文章，因为按钮点击后系统必定会dismiss，替代方案是重写按钮的点击逻辑：

val dialog = AlertDialog.Builder(this)
    .setTitle("输入内容")
    .setView(view)
    .setPositiveButton("确定", null)
    .create()
dialog.show()
// 覆盖按钮的点击行为，校验不通过则不关闭
dialog.getButton(AlertDialog.BUTTON_POSITIVE)?.setOnClickListener {
    val input = dialog.window?.findViewById<android.widget.EditText>(R.id.etInput)?.text.toString()
    if (input.isBlank()) {
        Toast.makeText(this, "内容不能为空", Toast.LENGTH_SHORT).show()
    } else {
        dialog.dismiss()
    }
}

这种写法的关键在于先调用show()再获取按钮，因为getButton在对话框展示之前返回null。掌握了这些细节，AlertDialog的使用基本就不会再有盲区了。实际开发中根据场景选择合适的形态：简单提示用Builder默认样式，复杂交互用setView自定义布局或DialogFragment包装，配合主题定制就能应对绝大多数弹窗需求。

Android AlertDialog对话框Android开发修改时间：2026-09-06 14:58:40