Java中Key为String、Value为List<UserInfo>的HashMap输出文件格式建议

针对你遇到的CSV重复Key导致可读性差的问题，推荐以下几种易读且实用的文件格式：

1. JSON格式 #

JSON是结构化存储的标准选择，天然支持键值对+数组的结构，每个Key只需要出现一次，对应的数组存放所有UserInfo对象，机器解析和人工阅读都很友好。

示例结构：

{
  "marketing_team": [
    {"id": 101, "name": "Lily", "category": "staff", "type": "fulltime"},
    {"id": 102, "name": "Tom", "category": "intern", "type": "temporary"}
  ],
  "engineering_team": [
    {"id": 201, "name": "Jack", "category": "dev", "type": "fulltime"},
    {"id": 202, "name": "Rose", "category": "qa", "type": "parttime"}
  ]
}

Java实现（使用Jackson库）：

import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.List;

public class JsonWriter {
    public static void main(String[] args) throws IOException {
        HashMap<String, List<UserInfo>> userMap = // 你的HashMap数据
        ObjectMapper objectMapper = new ObjectMapper();
        // 开启格式化输出，让JSON更易读
        objectMapper.writerWithDefaultPrettyPrinter()
                    .writeValue(new File("user_groups.json"), userMap);
    }
}

注意：需要给UserInfo类添加无参构造方法和所有属性的getter/setter，Jackson才能自动完成序列化。

2. YAML格式 #

YAML比JSON更简洁，语法更贴近自然文本，可读性更强，适合需要频繁人工查看的场景，结构逻辑和JSON完全一致。

示例结构：

marketing_team:
  - id: 101
    name: Lily
    category: staff
    type: fulltime
  - id: 102
    name: Tom
    category: intern
    type: temporary
engineering_team:
  - id: 201
    name: Jack
    category: dev
    type: fulltime
  - id: 202
    name: Rose
    category: qa
    type: parttime

Java实现（使用Jackson的YAML模块）：

import com.fasterxml.jackson.dataformat.yaml.YAMLMapper;
import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.List;

public class YamlWriter {
    public static void main(String[] args) throws IOException {
        HashMap<String, List<UserInfo>> userMap = // 你的HashMap数据
        YAMLMapper yamlMapper = new YAMLMapper();
        yamlMapper.writeValue(new File("user_groups.yaml"), userMap);
    }
}

注意：需要额外引入jackson-dataformat-yaml依赖，UserInfo类同样需要无参构造和getter/setter。

3. 自定义结构化文本格式 #

如果不想引入第三方库，可以自己定义轻量级的结构化格式，兼顾CSV的简洁和分组的清晰，每个Key对应一个分组，只显示一次表头。

示例结构：

=== marketing_team ===
id,name,category,type
101,Lily,staff,fulltime
102,Tom,intern,temporary

=== engineering_team ===
id,name,category,type
201,Jack,dev,fulltime
202,Rose,qa,parttime

Java实现（纯JDK API）：

import java.io.BufferedWriter;
import java.io.FileWriter;
import java.io.IOException;
import java.util.HashMap;
import java.util.List;

public class CustomTextWriter {
    public static void main(String[] args) throws IOException {
        HashMap<String, List<UserInfo>> userMap = // 你的HashMap数据
        try (BufferedWriter writer = new BufferedWriter(new FileWriter("user_groups.txt"))) {
            for (var entry : userMap.entrySet()) {
                // 写入分组标识
                writer.write("=== " + entry.getKey() + " ===");
                writer.newLine();
                // 写入表头
                writer.write("id,name,category,type");
                writer.newLine();
                // 写入每个用户信息
                for (UserInfo user : entry.getValue()) {
                    writer.write(String.format("%d,%s,%s,%s",
                            user.getId(), user.getName(), user.getCategory(), user.getType()));
                    writer.newLine();
                }
                // 分组之间空行分隔
                writer.newLine();
            }
        }
    }
}

这种格式不需要任何第三方依赖，实现简单，同时避免了CSV重复Key的问题，可读性也不错。

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