下面我将介绍几种最常用和最实用的方法,并附上代码示例和优缺点分析。

手动拼接（最灵活，代码量稍多）

这是最基础的方法，通过遍历 Map 的键值对，然后使用 StringBuilder 或 号将它们拼接成一个字符串。

示例代码

import java.util.HashMap;
import java.util.Map;
public class MapToStringExample {
    public static void main(String[] args) {
        Map<String, Integer> scores = new HashMap<>();
        scores.put("Alice", 95);
        scores.put("Bob", 88);
        scores.put("Charlie", 76);
        // 使用 StringBuilder 性能更好，尤其是在循环中
        StringBuilder sb = new StringBuilder();
        sb.append("{");
        for (Map.Entry<String, Integer> entry : scores.entrySet()) {
            sb.append(entry.getKey())
              .append("=")
              .append(entry.getValue())
              .append(", ");
        }
        // 移除最后多余的 ", "
        if (!scores.isEmpty()) {
            sb.setLength(sb.length() - 2);
        }
        sb.append("}");
        String result = sb.toString();
        System.out.println(result);
        // 输出: {Alice=95, Bob=88, Charlie=76}
    }
}

优点

• 完全可控：你可以自定义输出的格式，比如分隔符、是否加引号等。
• 无额外依赖：只需要 Java 标准库。
• 性能较好：StringBuilder 在循环拼接字符串时效率很高。

缺点

• 代码冗长：需要手动处理循环、拼接和结尾的特殊情况（如最后一个逗号）。
• 容易出错：忘记处理结尾的逗号或括号会导致格式错误。

使用 Map.toString()（最简单，但不推荐用于业务逻辑）

Map 接口本身继承自 Object，并重写了 toString() 方法,这个方法会返回一个标准的字符串表示形式。

示例代码

import java.util.HashMap;
import java.util.Map;
public class MapToStringExample {
    public static void main(String[] args) {
        Map<String, Integer> scores = new HashMap<>();
        scores.put("Alice", 95);
        scores.put("Bob", 88);
        scores.put("Charlie", 76);
        String result = scores.toString();
        System.out.println(result);
        // 输出: {Alice=95, Bob=88, Charlie=76}
    }
}

优点

• 极其简单：一行代码就能完成。
• 适用于调试：在打印日志或调试时非常方便。

缺点

• 格式固定：无法自定义输出格式。
• 不适合序列化：这个字符串的格式是给开发者看的，不是标准的 JSON 或其他机器可读格式,不适合用于网络传输或持久化存储。
• null 值处理：Map 本身是 null，调用 toString() 会抛出 NullPointerException。

使用 Jackson/Gson 等 JSON 库（最推荐，用于 API 和数据交换）

在现代应用中，最常见的需求是将 Map 转换为 JSON 字符串，以便用于 REST API 响应或数据存储，使用成熟的 JSON 库是最佳选择。

这里以 Jackson 为例，它是 Spring Boot 等框架的默认 JSON 库。

添加依赖 (Maven)

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version> <!-- 使用最新版本 -->
</dependency>

示例代码

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.HashMap;
import java.util.Map;
public class MapToJsonStringExample {
    public static void main(String[] args) {
        Map<String, Object> data = new HashMap<>();
        data.put("name", "John Doe");
        data.put("age", 30);
        data.put("isStudent", false);
        data.put("scores", Map.of("math", 90, "science", 85)); // 嵌套的 Map
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            // 将 Map 转换为格式化的 JSON 字符串
            String jsonString = objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(data);
            System.out.println(jsonString);
            // 也可以转换为紧凑的 JSON 字符串（无换行和缩进）
            // String compactJsonString = objectMapper.writeValueAsString(data);
            // System.out.println(compactJsonString);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }
    }
}

输出结果 (Pretty Print)

{
  "name" : "John Doe",
  "age" : 30,
  "isStudent" : false,
  "scores" : {
    "math" : 90,
    "science" : 85
  }
}

优点

• 功能强大：能正确处理复杂对象、嵌套结构、日期、null 值等。
• 标准格式：生成的 JSON 是通用的，可以被任何支持 JSON 的语言或库解析。
• 可配置性高：可以配置日期格式、忽略 null 值、美化输出等。
• 健壮性：能处理 null 的 Map 对象（会输出 null 字符串）。

缺点

• 需要引入外部依赖：如果你的项目不涉及 JSON,这个依赖就是多余的。

使用 Java 8 Stream API（函数式风格，灵活）

如果你不想引入外部库，但又想用更现代、更简洁的方式，可以使用 Java 8 的 Stream API。

示例代码

import java.util.HashMap;
import java.util.Map;
import java.util.stream.Collectors;
public class MapToStringWithStream {
    public static void main(String[] args) {
        Map<String, Integer> scores = new HashMap<>();
        scores.put("Alice", 95);
        scores.put("Bob", 88);
        scores.put("Charlie", 76);
        String result = scores.entrySet().stream()
                // 将每个 entry 转换为 "key=value" 的字符串
                .map(entry -> entry.getKey() + "=" + entry.getValue())
                // 用 ", " 连接所有字符串
                .collect(Collectors.joining(", ", "{", "}"));
        System.out.println(result);
        // 输出: {Alice=95, Bob=88, Charlie=76}
    }
}

优点

• 代码简洁：一行链式调用,非常优雅。
• 函数式编程：符合现代 Java 的编程风格。
• 灵活性高：可以轻松修改 map 和 collect 步骤来自定义格式。

缺点

• 性能开销：相比 StringBuilder，Stream 会有一定的性能损耗,但对于大多数应用场景来说可以忽略不计。
• 可读性：对于不熟悉 Stream 的开发者来说,可能需要一点时间来理解。

总结与选择建议

最终建议：

• 如果你要将 Map 用于网络传输或存储：毫不犹豫地选择 JSON 库（如 Jackson），这是行业标准，最安全、最可靠。
• 如果你只是想在日志里快速看一下 Map 的内容：直接用 System.out.println(myMap) 调用 toString() 方法。
• 如果你想在纯 Java 环境下自定义一个简单的字符串格式，且不想引入任何新依赖：使用 Java 8 Stream API 是最优雅的选择，如果对性能有极致要求,可以考虑手动拼接。