json格式用什么代码写

浅出：JSON格式的代码编写全指南

在当今的软件开发世界中,JSON（JavaScript Object Notation）已成为数据交换的事实标准，无论是Web API的响应、配置文件的编写，还是不同编程语言之间的数据传递，JSON都以其轻量、易读和易于解析的特性占据着核心地位，JSON格式究竟用什么代码来写呢？答案可能出乎你的意料：JSON本身并不是用某种编程语言来“写”的，它是一种独立于语言的、基于文本的数据格式规范。

你可以把它想象成一种通用的“数据语言”，就像英语是全球通用的语言一样，无论你使用Python、Java、JavaScript还是C#，你都可以“说”和“写”JSON，既然JSON是文本格式，我们自然会使用编程语言来创建、读取、修改和生成JSON数据，下面，我们就来详细探讨如何在不同场景下“写”出符合规范的JSON。

核心基础：手写JSON的“语法规则”

在任何编程语言操作JSON之前,你必须理解JSON的基本语法，这就像学写字前要先认识笔画和偏旁部首一样，JSON的语法非常简洁，主要由两种结构构成：

键值对 (Key-Value Pairs): 这是JSON的基本单元，类似于编程语言中的字典或哈希表。
- 格式: "键": "值"
- 规则:
  - 键必须是一个双引号包裹的字符串。
  - 值可以是多种类型：字符串（双引号）、数字、布尔值（true/false）、null、数组或对象。
结构体:
- 对象: 一个无序的键值对集合，用花括号包裹，多个键值对之间用逗号分隔。
  - 示例: {"name": "张三", "age": 30}
- 数组: 一个有序的值列表，用方括号 [] 包裹，多个值之间用逗号分隔。
  - 示例: [1, 2, "apple", true]

一个完整的JSON示例：

{
  "id": 101,
  "name": "一部智能手机",
  "price": 4999.00,
  "inStock": true,
  "tags": ["电子产品", "通讯", "5G"],
  "manufacturer": {
    "name": "某科技公司",
    "country": "中国"
  },
  "description": null
}

手写JSON时最容易犯的错误：

使用单引号代替双引号。
JSON对象或数组最后一个元素后面多了一个逗号,{"a": 1,}。
键名没有用双引号包裹。

在代码中“写”JSON：创建与生成

在实际编程中,我们很少手动去拼接一长串JSON文本，我们会利用语言内置的数据结构，然后通过库或内置函数将其序列化为JSON格式的字符串。

JavaScript / TypeScript (原生)

在JavaScript中,JSON是原生支持的，你直接使用对象字面量来创建数据结构，然后用 JSON.stringify() 方法将其转换为JSON字符串。

// 1. 创建一个JavaScript对象
const product = {
  id: 101,
  name: "一部智能手机",
  price: 4999.00,
  inStock: true,
  tags: ["电子产品", "通讯", "5G"],
  manufacturer: {
    name: "某科技公司",
    country: "中国"
  },
  description: null
};
// 2. 使用 JSON.stringify() 将对象“写”成JSON格式的字符串
const jsonString = JSON.stringify(product, null, 2); // 第二个参数是replacer，第三个参数是用于格式化的空格数
console.log(jsonString);
// 输出就是我们上面看到的那个格式化的JSON文本

Python

Python中,字典和列表的结构与JSON高度相似，我们使用 json 标准库来完成转换。

import json
# 1. 创建一个Python字典
product = {
  "id": 101,
  "name": "一部智能手机",
  "price": 4999.00,
  "inStock": True,
  "tags": ["电子产品", "通讯", "5G"],
  "manufacturer": {
    "name": "某科技公司",
    "country": "中国"
  },
  "description": None
}
# 2. 使用 json.dumps() 将字典“写”成JSON格式的字符串
# indent=2 用于格式化输出，让JSON更易读
json_string = json.dumps(product, indent=2, ensure_ascii=False)
print(json_string)
# ensure_ascii=False 确保中文字符能正确显示，而不是被转义

Java

在Java中,我们通常使用第三方库，如 Jackson 或 Gson，因为Java本身没有内置的原生支持（虽然现在有 javax.json API，但第三方库更流行、更强大）。

使用 Jackson 库：

确保你的项目中包含了 Jackson 的依赖。

import com.fasterxml.jackson.databind.ObjectMapper;
public class JsonWriter {
    public static void main(String[] args) throws Exception {
        // 1. 创建一个Java对象（POJO - Plain Old Java Object）
        Product product = new Product();
        product.setId(101);
        product.setName("一部智能手机");
        product.setPrice(4999.00);
        product.setInStock(true);
        // ... 省略其他属性的设置 ...
        // 2. 创建Jackson的ObjectMapper实例
        ObjectMapper objectMapper = new ObjectMapper();
        // 3. 使用 objectMapper.writeValueAsString() 将对象“写”成JSON格式的字符串
        String jsonString = objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(product);
        System.out.println(jsonString);
    }
}
// 一个简单的Product类
class Product {
    private int id;
    private String name;
    private double price;
    private boolean inStock;
    // ... getter和setter方法 ...
}

C

在C#中，.NET框架提供了强大的 System.Text.Json 命名空间，可以轻松完成JSON的序列化。

using System;
using System.Text.Json;
using System.Text.Json.Serialization;
// 1. 定义一个C#类来对应JSON结构
public class Product
{
    [JsonPropertyName("id")]
    public int Id { get; set; }
    [JsonPropertyName("name")]
    public string Name { get; set; }
    [JsonPropertyName("price")]
    public double Price { get; set; }
    [JsonPropertyName("inStock")]
    public bool InStock { get; set; }
}
public class Program
{
    public static void Main()
    {
        // 2. 创建一个Product对象实例
        var product = new Product
        {
            Id = 101,
            Name = "一部智能手机",
            Price = 4999.00,
            InStock = true
        };
        // 3. 使用 JsonSerializer.Serialize() 将对象“写”成JSON格式的字符串
        // WriteIndented = true 用于格式化输出
        string jsonString = JsonSerializer.Serialize(product, new JsonSerializerOptions { WriteIndented = true });
        Console.WriteLine(jsonString);
    }
}

用什么代码写？

回到最初的问题：“JSON格式用什么代码写？”

JSON本身： 不用任何编程语言代码写，它是一种文本格式，遵循严格的语法规范（双引号、逗号、花括号、方括号）。
生成JSON： 使用你熟悉的编程语言（如JavaScript, Python, Java, C#等）来构建数据结构（对象、字典、类实例），然后调用该语言的JSON序列化库或函数（如 JSON.stringify(), json.dumps(), Jackson, System.Text.Json）将这些数据结构转换为符合规范的JSON字符串。

与其问“用什么代码写JSON”，不如问“如何用我正在使用的编程语言来生成JSON数据”，了这个核心思想，你就能在任何技术栈中自如地处理JSON数据了。