如何将数据存入json中

如何将数据存入JSON：从基础到实践的全面指南

在当今数据驱动的时代,JSON（JavaScript Object Notation）已成为轻量级数据交换的主流格式，它以易读、易解析的结构特性，被广泛应用于Web开发、API接口、配置文件等场景，将数据存入JSON是许多开发者的基础技能，本文将从JSON的基础概念出发，详细讲解不同数据类型、编程语言中的存入方法，以及常见问题的解决方案，帮助你数据存储的核心技巧。

JSON：为什么选择它存储数据？

在了解“如何存入”之前，先明确“为什么存入JSON”，JSON是一种基于文本的数据格式，采用“键值对”（Key-Value Pair）的嵌套结构，类似于JavaScript中的对象，它的核心优势包括：

• 轻量级：相比XML等格式，JSON冗余信息少，数据更紧凑，传输效率更高。
• 易读易写：文本格式直观，人类可读，也方便开发者调试。
• 跨语言兼容：几乎所有主流编程语言（Python、Java、JavaScript、C++等）都支持JSON的解析和生成，不同语言间的数据交互无障碍。
• 结构灵活：支持嵌套对象和数组，能表示复杂的数据关系（如树形结构、列表数据等）。

JSON的基本语法规则：存入数据的前提

要将数据正确存入JSON,需先其语法规范，JSON的数据结构分为两种：对象（Object）和数组（Array），其他数据类型都是它们的“值”。

对象（Object）：键值对的集合

对象用 包裹，内部由多个键值对组成，键和值用 分隔，键值对之间用 分隔。

• 键（Key）：必须是字符串，且必须用双引号 包围（单引号会报错）。
• 值（Value）：可以是多种数据类型（见下文）。

示例：

{
  "name": "张三",
  "age": 25,
  "isStudent": false
}

数组（Array）：有序值的集合

数组用 [] 包裹，内部由多个值组成，值之间用 分隔，数组的值可以是任意JSON数据类型（包括对象和嵌套数组）。

示例：

[
  {"name": "李四", "age": 30},
  {"name": "王五", "age": 28}
]

JSON支持的数据类型

JSON原生支持以下6种数据类型,存入数据时需根据需求选择：

• 字符串（String）：用 包围，如 "Hello"。
• 数字（Number）：整数或浮点数，如 100、14（不支持八进制、十六进制，但支持科学计数法，如 1e5）。
• 布尔值（Boolean）：true 或 false（注意全小写，首字母大写会报错）。
• null：表示空值，如 "address": null。
• 对象（Object）：键值对集合，如上述示例。
• 数组（Array）：有序值集合，如上述示例。

如何将数据存入JSON：分场景实践

不同编程语言中,将数据存入JSON的语法略有差异，但核心逻辑一致：构建符合JSON语法的数据结构，再将其序列化为JSON字符串，以下是常见语言的实践方法。

场景1：Python中存入JSON

Python内置了 json 模块，用于处理JSON数据的编码（Python对象→JSON字符串）和解码（JSON字符串→Python对象）。

（1）基础数据存入：字典→JSON字符串

Python中的字典（dict）天然对应JSON对象，列表（list）对应JSON数组。

import json
# 1. 准备Python数据（字典/列表）
user_data = {
    "name": "张三",
    "age": 25,
    "hobbies": ["reading", "coding"],  # 列表对应JSON数组
    "info": {"city": "Beijing"}        # 嵌套字典对应JSON对象
}
# 2. 使用json.dumps()将Python对象序列化为JSON字符串
json_str = json.dumps(user_data, ensure_ascii=False, indent=4)
# ensure_ascii=False：支持非ASCII字符（如中文）原样输出，不转义为Unicode
# indent=4：格式化输出，缩进4个空格，提高可读性
# 3. 输出或保存JSON字符串
print(json_str)
# 保存到文件
with open("user.json", "w", encoding="utf-8") as f:
    f.write(json_str)

输出结果（user.json）：

{
    "name": "张三",
    "age": 25,
    "hobbies": [
        "reading",
        "coding"
    ],
    "info": {
        "city": "Beijing"
    }
}

（2）动态数据存入：从用户输入/数据库写入

假设从用户输入获取数据,并存入JSON文件：

import json
# 模拟用户输入
new_user = {
    "name": input("请输入姓名："),
    "age": int(input("请输入年龄：")),
    "is_active": input("是否激活？（true/false）").lower() == "true"
}
# 读取现有JSON文件（若存在），或创建新列表
try:
    with open("users.json", "r", encoding="utf-8") as f:
        users = json.load(f)  # 将JSON字符串反序列化为Python对象
except FileNotFoundError:
    users = []  # 文件不存在时，初始化空列表
# 添加新用户
users.append(new_user)
# 保存回文件
with open("users.json", "w", encoding="utf-8") as f:
    json.dump(users, f, ensure_ascii=False, indent=4)  # json.dump()直接写入文件
print("数据已保存到users.json")

场景2：JavaScript（Node.js）中存入JSON

JavaScript中,JSON本身就是原生支持的格式，无需额外模块，核心方法是 JSON.stringify()（对象→字符串）和 JSON.parse()（字符串→对象）。

（1）基础数据存入：对象→JSON字符串

// 1. 准备JavaScript对象
const product = {
  id: 1001,
  name: "笔记本电脑",
  price: 5999.99,
  specs: ["16GB内存", "512GB固态硬盘"],  // 数组对应JSON数组
  inStock: true
};
// 2. 使用JSON.stringify()序列化为JSON字符串
const jsonStr = JSON.stringify(product, null, 2);  // 第二个参数用于过滤，第三个参数缩进
console.log(jsonStr);
// 3. 保存到文件（Node.js环境）
const fs = require('fs');
fs.writeFileSync('product.json', jsonStr, 'utf-8');

输出结果（product.json）：

{
  "id": 1001,
  "name": "笔记本电脑",
  "price": 5999.99,
  "specs": [
    "16GB内存",
    "512GB固态硬盘"
  ],
  "inStock": true
}

（2）动态数据存入：表单数据/API响应

假设从表单获取数据,并追加到JSON文件：

const fs = require('fs');
// 模拟表单提交数据
const formData = {
  username: "user123",
  email: "user123@example.com",
  createdAt: new Date().toISOString()  // 使用ISO格式时间
};
// 读取现有文件
let users = [];
try {
  const data = fs.readFileSync('users.json', 'utf-8');
  users = JSON.parse(data);  // 反序列化为JS对象
} catch (err) {
  console.log("文件不存在，将创建新文件");
}
// 添加新数据
users.push(formData);
// 保存回文件
fs.writeFileSync('users.json', JSON.stringify(users, null, 2), 'utf-8');
console.log("数据已保存");

场景3：Java中存入JSON

Java中处理JSON常用第三方库,如 Gson（Google）、Jackson、org.json，这里以轻量级的 org.json 为例（Maven依赖：org.json:json:20231013）。

（1）基础数据存入：对象→JSON字符串

import org.json.JSONObject;
import java.io.FileWriter;
import java.io.IOException;
public class JsonStorage {
    public static void main(String[] args) {
        // 1. 构建JSONObject（对应JSON对象）
        JSONObject student = new JSONObject();
        student.put("name", "李四");
        student