ListView搭配CheckedTextView多选异常求助：复选框消失、行误选

看起来你碰到了ListView视图复用引发的多选状态错乱问题——复选框消失、误选其他行都是典型的复用导致状态未正确保存的表现。别担心，咱们一步步来修复：

问题根源 #

ListView为了优化性能会复用convertView，如果咱们直接操作视图的选中状态而不把状态存在数据模型里，滚动列表时旧视图的状态会被带到新的列表项上，就会出现误选、复选框状态异常的情况。

解决方案步骤 #

1. 创建数据模型类，保存每个列表项的状态 #

首先给每个列表项创建一个模型，用来存储文本内容和选中状态，这样状态就不会跟着视图复用丢失了：

public class ServiceItem {
    private String serviceName;
    private boolean isChecked;

    public ServiceItem(String serviceName, boolean isChecked) {
        this.serviceName = serviceName;
        this.isChecked = isChecked;
    }

    // Getter & Setter方法
    public String getServiceName() {
        return serviceName;
    }

    public void setServiceName(String serviceName) {
        this.serviceName = serviceName;
    }

    public boolean isChecked() {
        return isChecked;
    }

    public void setChecked(boolean checked) {
        isChecked = checked;
    }
}

2. 修复行布局的复选框样式 #

确保你的CheckedTextView的checkMark属性使用系统的多选指示器，避免样式异常导致复选框消失：

<CheckedTextView
    android:id="@+id/service_name"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="TextView"
    android:textSize="20sp"
    android:layout_marginBottom="10dp"
    android:checkMark="?android:attr/listChoiceIndicatorMultiple"
    android:paddingVertical="12dp"
    android:paddingHorizontal="16dp"/>

3. 自定义Adapter，正确绑定数据和状态 #

Adapter是核心，咱们要在getView里根据数据模型设置视图状态，点击时更新模型而不是只修改视图：

public class ServiceListAdapter extends ArrayAdapter<ServiceItem> {
    private List<ServiceItem> mServiceItems;

    public ServiceListAdapter(Context context, List<ServiceItem> serviceItems) {
        super(context, 0, serviceItems);
        mServiceItems = serviceItems;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        CheckedTextView checkedTextView;

        // 复用视图或创建新视图
        if (convertView == null) {
            checkedTextView = (CheckedTextView) LayoutInflater.from(getContext())
                    .inflate(R.layout.your_list_item_layout, parent, false);
        } else {
            checkedTextView = (CheckedTextView) convertView;
        }

        // 获取当前项的模型数据
        ServiceItem currentItem = mServiceItems.get(position);

        // 绑定文本和选中状态（关键：从模型取状态，而非视图本身）
        checkedTextView.setText(currentItem.getServiceName());
        checkedTextView.setChecked(currentItem.isChecked());

        // 设置点击事件，同步更新视图和模型状态
        checkedTextView.setOnClickListener(v -> {
            CheckedTextView ctv = (CheckedTextView) v;
            boolean newCheckedState = !ctv.isChecked();
            ctv.setChecked(newCheckedState);
            // 核心步骤：更新模型状态，确保状态持久化
            currentItem.setChecked(newCheckedState);
        });

        return checkedTextView;
    }
}

4. 在Activity/Fragment中初始化ListView #

最后在页面里初始化数据、Adapter，并设置ListView的多选模式：

// 初始化数据列表
List<ServiceItem> serviceList = new ArrayList<>();
serviceList.add(new ServiceItem("服务A", false));
serviceList.add(new ServiceItem("服务B", false));
serviceList.add(new ServiceItem("服务C", false));
// 可添加更多项...

// 设置Adapter
ServiceListAdapter adapter = new ServiceListAdapter(this, serviceList);
ListView listView = findViewById(R.id.your_list_view_id);
listView.setAdapter(adapter);

// 开启ListView的多选模式，增强多选体验
listView.setChoiceMode(ListView.CHOICE_MODE_MULTIPLE);

5. 获取所有选中项 #

如果需要拿到用户选中的所有项，直接遍历数据模型列表即可：

List<ServiceItem> selectedServices = new ArrayList<>();
for (ServiceItem item : serviceList) {
    if (item.isChecked()) {
        selectedServices.add(item);
    }
}
// 处理选中的服务项

这样修改后，ListView的复用就不会再导致状态错乱了，复选框也能稳定显示和切换状态。

内容的提问来源于stack exchange，提问作者meenakshi agrawal