ListView中ArrayAdapter视图复用导致选中项重复的问题求助

嘿，我太懂你遇到的这个糟心问题了——ListView的视图复用机制确实是不少Android开发者初期会踩的坑，滚动后复选框状态乱跳就是最典型的症状。让我一步步帮你搞定它：

问题根源 #

ListView为了优化性能，会把滚出屏幕的列表项视图重新拿来复用。当你勾选一个item后，这个视图被滚出屏幕再用来显示另一个item时，它会带着之前的选中状态，而你没有根据当前item的实际数据去更新状态，就出现了“随机项被选中”的情况。

解决方案 #

核心思路是把每个item的选中状态和数据绑定在一起，而不是依赖视图本身的状态。我们需要单独维护状态集合，再自定义Adapter来确保每个item显示时都能读取正确的状态。

步骤1：添加选中状态集合 #

在你的Activity里，新增一个和联系人列表一一对应的布尔集合，用来保存每个item的选中状态：

private ArrayList<Boolean> isCheckedList;

步骤2：自定义ArrayAdapter #

放弃系统默认的ArrayAdapter，自己实现一个，重写getView方法来精准控制复选框状态：

private class CustomContactsAdapter extends ArrayAdapter<String> {
    public CustomContactsAdapter(Context context, ArrayList<String> contacts) {
        super(context, android.R.layout.simple_list_item_multiple_choice, contacts);
        // 初始化状态集合，默认所有item都未选中
        isCheckedList = new ArrayList<>();
        for (int i = 0; i < contacts.size(); i++) {
            isCheckedList.add(false);
        }
    }

    @Override
    public View getView(final int position, View convertView, ViewGroup parent) {
        CheckedTextView checkedTextView = (CheckedTextView) super.getView(position, convertView, parent);
        // 关键操作：根据状态集合设置当前item的选中状态，覆盖复用视图的旧状态
        checkedTextView.setChecked(isCheckedList.get(position));
        return checkedTextView;
    }

    // 提供方法切换指定位置的选中状态
    public void toggleChecked(int position) {
        isCheckedList.set(position, !isCheckedList.get(position));
        notifyDataSetChanged(); // 通知Adapter刷新视图
    }

    // 可选：获取所有选中的联系人
    public ArrayList<String> getSelectedContacts() {
        ArrayList<String> selected = new ArrayList<>();
        for (int i = 0; i < contacts.size(); i++) {
            if (isCheckedList.get(i)) {
                selected.add(contacts.get(i));
            }
        }
        return selected;
    }
}

步骤3：修正Activity代码（解决潜在空指针） #

你原来的代码里还有个小隐患：contacts是在权限通过后才初始化的，直接在onCreate里设置Adapter会导致空指针。我们需要把Adapter的初始化移到权限通过后的get()方法执行完毕后：

修改后的核心代码：

private static final String TAG = viewContacts.class.getSimpleName();
private ListView viewContacts;
private CustomContactsAdapter adapter;
private ArrayList<String> contacts;
private Cursor c;
private ArrayList<Boolean> isCheckedList;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_view_contacts);
    viewContacts = findViewById(R.id.contactsView);

    Dexter.withActivity(this)
        .withPermission(Manifest.permission.READ_CONTACTS)
        .withListener(new PermissionListener() {
            @Override
            public void onPermissionGranted(PermissionGrantedResponse response) {
                get();
                // 权限通过、联系人数据加载完成后，再初始化Adapter
                adapter = new CustomContactsAdapter(viewContacts.this, contacts);
                viewContacts.setAdapter(adapter);
            }

            @Override
            public void onPermissionDenied(PermissionDeniedResponse response) {
                if (response.isPermanentlyDenied()) {
                    // 可选：引导用户跳转到应用设置开启权限
                    Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
                    Uri uri = Uri.fromParts("package", getPackageName(), null);
                    intent.setData(uri);
                    startActivity(intent);
                }
            }

            @Override
            public void onPermissionRationaleShouldBeShown(PermissionRequest permission, PermissionToken token) {
                token.continuePermissionRequest();
            }
        }).check();

    // 设置item点击事件，调用Adapter的方法切换状态
    viewContacts.setOnItemClickListener(new AdapterView.OnItemClickListener() {
        @Override
        public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
            if (adapter != null) {
                adapter.toggleChecked(position);
            }
        }
    });
}

public void get(){
    c = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, 
            null, null, null, ContactsContract.Contacts.DISPLAY_NAME );
    contacts = new ArrayList<>();
    while(c.moveToNext()){
        String contactName = c.getString(c.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
        String phoneNumber = c.getString(c.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
        contacts.add( contactName + "\n" + phoneNumber);
        Log.d(TAG, "show contacts:" + contactName + " " + phoneNumber);
    }
    c.close();
}

为什么这样能解决问题？ #

• 我们用isCheckedList把每个item的选中状态和数据绑定，不会因为视图复用丢失状态；
• 在getView方法里，每次显示item都会从状态集合读取对应位置的状态，强制覆盖复用视图的旧状态；
• 点击item时直接更新状态集合并通知Adapter刷新，确保视图显示的是最新状态。

这样修改后，你滚动ListView时，复选框的状态就不会乱跳啦！

内容的提问来源于stack exchange，提问作者Jean Van Niekerk