本文介绍如何在 android listview 中模拟单选行为，使多个 checkbox 只能有一个处于选中状态，解决因所有 checkbox 共享同一 id 而无法独立控制的问题。
本文介绍如何在 android listview 中模拟单选行为，使多个 checkbox 只能有一个处于选中状态，解决因所有 checkbox 共享同一 id 而无法独立控制的问题。
在 Android 开发中，ListView 中的每个条目若包含 CheckBox，默认是独立可操作的——这与 RadioButton 的互斥特性不同。但当业务需求要求“仅允许选中一项”（如选择默认地址、指定主设备等），就需要手动管理选中状态。直接使用 RadioGroup 并不可行：RadioGroup 仅支持其直接子 View（且通常为 RadioButton），而 ListView 的 item 是动态生成的，CheckBox 位于不同 convertView 中，无法统一纳入同一个 RadioGroup 容器。
✅ 正确做法是：在 Adapter 中维护一个全局选中索引（如 selectedPosition），并在 CheckBox 点击时同步更新状态。
以下是关键实现步骤：
-
在自定义 Adapter 中声明选中位置变量：
private int selectedPosition = -1; // -1 表示无选中项
-
在 getView() 中绑定 CheckBox 状态与点击逻辑：
@Override public View getView(int position, View convertView, ViewGroup parent) { ViewHolder holder; if (convertView == null) { convertView = LayoutInflater.from(context).inflate(R.layout.list_item_with_checkbox, parent, false); holder = new ViewHolder(); holder.checkBox = convertView.findViewById(R.id.checkbox); convertView.setTag(holder); } else { holder = (ViewHolder) convertView.getTag(); } // 设置当前项文本等数据 holder.checkBox.setText(getItem(position).getName()); // 同步 UI：仅当前 position 匹配时选中 holder.checkBox.setChecked(position == selectedPosition); // 设置点击监听器 holder.checkBox.setOnClickListener(v -> { boolean isChecked = ((CheckBox) v).isChecked(); if (isChecked) { selectedPosition = position; // 记录新选中项 notifyDataSetChanged(); // 刷新所有 item，确保旧选项被取消 } // 注意：无需处理 unchecked 情况，因为点击已由用户触发且逻辑由 selectedPosition 控制 }); return convertView; } -
补充 ViewHolder 类（推荐）：
static class ViewHolder { CheckBox checkBox; }
⚠️ 注意事项：
- 避免在 setChecked() 后立即调用 performClick() 或重复设置监听器，否则可能引发递归调用或状态错乱；
- 若 ListView 启用 setChoiceMode(ListView.CHOICE_MODE_SINGLE)，需配合 setItemChecked() 使用，但该方式对自定义 CheckBox 不生效，仍需依赖 Adapter 内部状态管理；
- 在 Fragment 或 Activity 重建（如旋转）时，应将 selectedPosition 保存至 onSaveInstanceState()，防止状态丢失；
- 若使用 RecyclerView（更现代方案），推荐改用 RecyclerView.Adapter + notifyItemChanged() 提升性能与可维护性。
总结：虽然视觉上希望 CheckBox 表现如 RadioButton，但 Android 原生机制不支持跨 ListItem 的 RadioGroup。唯一健壮、可控的方式是在 Adapter 层统一维护选中状态，并通过 notifyDataSetChanged() 触发 UI 同步。这种方法兼容性强、逻辑清晰，且完全规避了 ID 冲突与布局约束问题。
