在Java开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，被广泛应用于前后端数据交互、配置文件存储等场景，而JSON字符串的拼接则是处理数据时的基础操作，掌握高效、规范的拼接方法对提升代码质量和开发效率至关重要，本文将系统介绍Java中拼接JSON字符串的多种方式，从基础手动拼接到使用第三方库的高级实现,并分析其优缺点及适用场景。
手动拼接JSON字符串
手动拼接是最直接的方式，通过字符串连接操作（如或StringBuilder）按照JSON格式规范逐个拼接字段和值，这种方式无需依赖额外库，适合处理结构简单、字段较少的JSON数据。
基础字符串拼接
对于简单的JSON对象,可以直接使用号连接字符串。
String name = "张三";
int age = 25;
String jsonStr = "{\"name\":\"" + name + "\",\"age\":" + age + "}";
但这种方式存在明显缺点：当字段较多或包含特殊字符（如双引号、换行符）时，代码可读性极差，且容易因转义不当导致格式错误，频繁的字符串拼接会创建大量临时对象,影响性能。
使用StringBuilder优化
为提升性能，可采用StringBuilder减少中间对象的创建：
StringBuilder sb = new StringBuilder();
sb.append("{");
sb.append("\"name\":\"").append(name).append("\",");
sb.append("\"age\":").append(age);
sb.append("}");
String jsonStr = sb.toString();
相比直接使用，StringBuilder在循环拼接场景中优势更明显，但仍需手动处理逗号、引号等格式问题,维护成本较高。
使用JSON库简化拼接
实际开发中，JSON数据结构往往更复杂，手动拼接容易出错，借助成熟的JSON库（如Gson、Jackson、Fastjson）能大幅提升开发效率和代码可读性。
使用Gson库
Google的Gson库提供了JsonObject类,支持通过键值对构建JSON对象：
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
JsonObject jsonObject = new JsonObject();
jsonObject.addProperty("name", "李四");
jsonObject.addProperty("age", 30);
jsonObject.addProperty("isStudent", false);
String jsonStr = jsonObject.toString();
Gson会自动处理数据类型转换和特殊字符转义，代码简洁且不易出错，对于嵌套JSON，可通过创建多个JsonObject组合实现：
JsonObject address = new JsonObject();
address.addProperty("city", "北京");
address.addProperty("district", "朝阳区");
jsonObject.add("address", address);
使用Jackson库
Jackson的ObjectMapper是核心类，支持将Java对象（POJO）转换为JSON字符串，通过定义实体类,映射JSON结构：
import com.fasterxml.jackson.databind.ObjectMapper;
class User {
private String name;
private int age;
// getters/setters
}
User user = new User();
user.setName("王五");
user.setAge(28);
ObjectMapper mapper = new ObjectMapper();
String jsonStr = mapper.writeValueAsString(user);
这种方式结合了面向对象编程思想，适合结构固定的JSON数据，若需动态拼接，可结合JsonNode类：
import com.fasterxml.jackson.databind.node.JsonNodeFactory;
import com.fasterxml.jackson.databind.node.ObjectNode;
ObjectNode node = JsonNodeFactory.instance.objectNode();
node.put("name", "赵六");
node.put("age", 35);
String jsonStr = node.toString();
使用Fastjson库
Fastjson（阿里巴巴开源）以高性能著称，其JSONObject类使用方式与Gson类似：
import com.alibaba.fastjson.JSONObject;
JSONObject jsonObject = new JSONObject();
jsonObject.put("name", "钱七");
jsonObject.put("age", 40);
String jsonStr = jsonObject.toJSONString();
Fastjson支持直接将Map或List转换为JSON,灵活性较高：
Map<String, Object> data = new HashMap<>();
data.put("name", "孙八");
data.put("age", 45);
String jsonStr = JSONObject.toJSONString(data);
拼接JSON数组
当需要处理JSON数组时，可通过集合类结合JSON库实现,例如使用Gson拼接数组：
import com.google.gson.JsonArray;
import com.google.gson.JsonElement;
JsonArray jsonArray = new JsonArray();
for (int i = 0; i < 3; i++) {
JsonObject item = new JsonObject();
item.addProperty("index", i);
item.addProperty("value", "item" + i);
jsonArray.add(item);
}
String jsonStr = jsonArray.toString();
Jackson和Fastjson也提供了类似API，如Jackson的ArrayNode和Fastjson的JSONArray。
拼接时的注意事项
- 特殊字符处理：JSON字符串中的双引号、反斜杠等需转义，使用JSON库可自动处理，手动拼接时需注意添加反斜杠（如
\"）。 - 数据类型匹配：数值类型（如
int、double）直接拼接，字符串类型需加双引号，布尔值和null有固定表示（true、false、null）。 - 性能优化：高频拼接场景优先使用
StringBuilder或JSON库的流式API（如Jackson的JsonGenerator）,减少内存消耗。 - 异常处理：JSON库在转换过程中可能抛出异常（如
JsonSyntaxException），需做好捕获和处理,避免程序崩溃。
Java中拼接JSON字符串的方式需根据实际场景选择：简单临时场景可采用手动拼接（配合StringBuilder），复杂或生产环境推荐使用Gson、Jackson、Fastjson等库，JSON库不仅能减少编码量，还能确保格式正确性和数据安全性，是现代Java开发中的必备工具，选择时可根据项目需求（如性能、依赖、易用性）综合评估，例如Gson适合Android开发，Jackson在Spring生态中应用广泛，Fastjson则以解析速度快著称，掌握多种拼接方法，并根据场景灵活运用,能显著提升开发效率和代码质量。
