如何实现基于Map分组的ListView：每组元素后添加Header/分隔符

嘿，这个需求我帮你捋清楚了，其实核心就是把分组的Map数据转换成ListView能识别的线性混合列表，再通过自定义Adapter区分不同类型的项就行。下面是一步步的实现方案，亲测好用！

第一步：定义统一的列表项模型 #

因为我们的列表里既有普通的文件项，又有分组后的分隔符/Header，所以得先创建一个实体类来标记每个项的类型和对应数据：

public class ListItem {
    // 标记项类型：0=普通文件项，1=分组分隔符/Header
    public int type;
    // 存储对应数据：文件项存File对象，分隔符存分组标题（String）
    public Object data;

    public ListItem(int type, Object data) {
        this.type = type;
        this.data = data;
    }
}

第二步：把Map数据转成混合列表 #

你的原始数据是Map<String, ArrayList<File>>，但HashMap是无序的，如果需要分组按插入顺序展示，建议换成LinkedHashMap。然后遍历每个分组，先把该组的所有文件添加到列表，再添加对应的分隔符项：

// 把原始HashMap转成LinkedHashMap保证顺序（可选，按需使用）
Map<String, ArrayList<File>> orderedGroups = new LinkedHashMap<>(yourOriginalMap);
ArrayList<ListItem> mixedList = new ArrayList<>();

for (Map.Entry<String, ArrayList<File>> entry : orderedGroups.entrySet()) {
    String groupName = entry.getKey();
    ArrayList<File> groupFiles = entry.getValue();

    // 先添加当前组的所有文件项
    for (File file : groupFiles) {
        mixedList.add(new ListItem(0, file));
    }

    // 添加该组的分隔符/Header项
    mixedList.add(new ListItem(1, groupName));
}

// 可选：如果不想最后一组后面也显示分隔符，移除最后一个元素
if (!mixedList.isEmpty() && mixedList.get(mixedList.size()-1).type == 1) {
    mixedList.remove(mixedList.size()-1);
}

第三步：自定义多类型Adapter #

继承BaseAdapter，重写getItemViewType和getViewTypeCount方法，让ListView能区分不同类型的项，实现视图复用：

public class GroupedListAdapter extends BaseAdapter {
    private Context mContext;
    private ArrayList<ListItem> mMixedList;

    // 定义两种视图类型
    private static final int VIEW_TYPE_FILE = 0;
    private static final int VIEW_TYPE_SEPARATOR = 1;

    public GroupedListAdapter(Context context, ArrayList<ListItem> mixedList) {
        mContext = context;
        mMixedList = mixedList;
    }

    @Override
    public int getCount() {
        return mMixedList.size();
    }

    @Override
    public Object getItem(int position) {
        return mMixedList.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    // 返回当前项的视图类型
    @Override
    public int getItemViewType(int position) {
        return mMixedList.get(position).type;
    }

    // 返回视图类型总数
    @Override
    public int getViewTypeCount() {
        return 2;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        ViewHolder holder;
        int viewType = getItemViewType(position);

        if (convertView == null) {
            holder = new ViewHolder();
            if (viewType == VIEW_TYPE_FILE) {
                // 加载文件项布局
                convertView = LayoutInflater.from(mContext).inflate(R.layout.item_file, parent, false);
                holder.fileNameTv = convertView.findViewById(R.id.tv_file_name);
            } else {
                // 加载分隔符/Header布局
                convertView = LayoutInflater.from(mContext).inflate(R.layout.item_separator, parent, false);
                holder.separatorTitleTv = convertView.findViewById(R.id.tv_separator_title);
            }
            convertView.setTag(holder);
        } else {
            holder = (ViewHolder) convertView.getTag();
        }

        // 绑定数据到视图
        ListItem currentItem = mMixedList.get(position);
        if (viewType == VIEW_TYPE_FILE) {
            File file = (File) currentItem.data;
            holder.fileNameTv.setText(file.getName());
        } else {
            String groupTitle = (String) currentItem.data;
            holder.separatorTitleTv.setText("分组：" + groupTitle);
        }

        return convertView;
    }

    // ViewHolder优化视图复用
    static class ViewHolder {
        TextView fileNameTv;
        TextView separatorTitleTv;
    }
}

第四步：创建对应的布局文件 #

需要两个布局文件，分别对应文件项和分隔符项：

文件项布局（item_file.xml） #

<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/tv_file_name"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp"
    android:textSize="16sp"
    android:textColor="#333333"/>

分隔符/Header布局（item_separator.xml） #

<TextView xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/tv_separator_title"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="12dp"
    android:textSize="14sp"
    android:background="#f5f5f5"
    android:textColor="#666666"/>

第五步：在页面中设置ListView #

最后在Activity或Fragment里初始化ListView并设置Adapter：

ListView listView = findViewById(R.id.your_list_view_id);
GroupedListAdapter adapter = new GroupedListAdapter(this, mixedList);
listView.setAdapter(adapter);

一些额外提示 #

• 如果你的实际需求是每组元素之前显示Header（这是更常见的分组样式），只需要调整数据转换的顺序：先添加分隔符/Header项，再添加该组的所有文件项即可。
• 关于分组顺序：如果需要分组按特定顺序排列，比如按分组名称排序，可以用TreeMap代替LinkedHashMap。
• 性能考量：如果数据量很大，推荐用RecyclerView代替ListView，实现逻辑类似，也是通过多类型Item实现，RecyclerView的滑动性能和扩展性更好。

内容的提问来源于stack exchange，提问作者Rajesh K