如何获取json的名称

如何获取JSON的名称：从基础到实践的全面指南

在数据交互的世界里，JSON（JavaScript Object Notation）以其轻量、易读和易解析的特性，已成为前后端数据交换的主流格式，无论是调用API接口、处理配置文件，还是解析数据库返回结果，我们经常需要从JSON数据中提取特定的“名称”（即键名或字段名），本文将从JSON的基础结构出发，详细讲解在不同场景下获取JSON名称的方法，涵盖手动解析、编程语言处理、工具辅助等实用技巧,帮助你高效JSON名称的获取逻辑。

先搞懂：JSON中的“名称”是什么？

要获取JSON的名称，首先要明确JSON中“名称”的定义，JSON数据主要由两种结构组成：对象（Object）和数组（Array），名称”主要存在于对象结构中。

JSON对象的基本结构

JSON对象由“键值对”（Key-Value Pair）组成，格式为：
{"名称1": 值1, "名称2": 值2, "名称3": 值3}

这里的“名称”就是键名（Key），它必须是字符串类型（用双引号包裹），而值（Value）可以是字符串、数字、布尔值、数组、对象甚至null。

{
  "name": "张三",
  "age": 25,
  "isStudent": true,
  "courses": ["数学", "英语"],
  "address": {
    "city": "北京",
    "district": "海淀区"
  }
}

在这个例子中，"name"、"age"、"isStudent"、"courses"、"address"都是JSON对象的“名称”（键名）。

JSON数组中的“名称”

JSON数组（用方括号[]表示）是值的有序集合，本身没有“名称”，但数组中的元素可能是对象，这些对象内部包含名称。

[
  {"id": 1, "product": "手机"},
  {"id": 2, "product": "电脑"},
  {"id": 3, "product": "平板"}
]

这里的数组元素是对象，每个对象都有自己的名称（"id"、"product"）,因此获取数组中对象的名称是常见需求。

手动获取JSON名称：适合简单场景

如果JSON数据结构简单（例如只有一层嵌套），或者你只是临时查看某个JSON文件的键名，手动解析是最直接的方法。

通过文本编辑器查看

用VS Code、Sublime Text等文本编辑器打开JSON文件，直接搜索和，即可定位键名。

{"code": 200, "message": "success", "data": {"userId": 123, "userName": "李四"}}

可以看到第一层的键名是"code"、"message"、"data"，第二层（嵌套在"data"中）的键名是"userId"、"userName"。

使用在线JSON格式化工具

对于复杂的JSON数据（多层嵌套、缩进混乱），手动查看容易出错，此时可以使用在线JSON格式化工具（如JSON Formatter、Beautifier.io），将JSON粘贴进去，工具会自动整理缩进并高亮显示键名，方便快速浏览。

将上面的复杂JSON粘贴到格式化工具后，输出为：

{
  "code": 200,
  "message": "success",
  "data": {
    "userId": 123,
    "userName": "李四"
  }
}

键名被清晰展示,层级关系一目了然。

编程获取JSON名称：适合自动化处理

在实际开发中，我们通常需要通过代码动态获取JSON的名称（例如根据键名提取数据、遍历所有键名等），不同编程语言提供了丰富的API支持,以下是常见语言的实现方法。

Python：使用字典操作

Python中JSON数据通常通过json模块解析为字典（dict），字典的键名就是我们需要的“名称”。

（1）获取单层JSON的所有键名

使用字典的keys()方法，返回包含所有键名的视图（view），可转换为列表遍历：

import json
json_str = '{"name": "王五", "age": 30, "city": "上海"}'
data = json.loads(json_str)  # 解析为字典
# 获取所有键名
keys = list(data.keys())
print(keys)  # 输出: ['name', 'age', 'city']

（2）获取嵌套JSON的键名（递归处理）

对于多层嵌套的JSON，需要递归遍历对象（字典）和数组（列表）：

def get_all_keys(obj, keys_list=None):
    if keys_list is None:
        keys_list = []
    if isinstance(obj, dict):
        for key in obj.keys():
            keys_list.append(key)
            # 递归处理嵌套的字典或数组
            get_all_keys(obj[key], keys_list)
    elif isinstance(obj, list):
        for item in obj:
            get_all_keys(item, keys_list)
    return keys_list
json_str = '''
{
  "id": 1,
  "info": {"name": "赵六", "hobbies": ["篮球", "阅读"]},
  "scores": [90, 85, 78]
}
'''
data = json.loads(json_str)
all_keys = get_all_keys(data)
print(all_keys)  # 输出: ['id', 'info', 'name', 'hobbies', 'scores']

（3）根据路径获取特定键名

如果知道键名的层级路径（如"info.name"），可以用get()方法逐层获取：

name = data.get("info", {}).get("name")
print(name)  # 输出: 赵六

JavaScript：使用对象操作

JavaScript中JSON数据通过JSON.parse()解析为对象（Object），对象的属性名即JSON的“名称”。

（1）获取单层JSON的所有键名

使用Object.keys()方法，返回包含所有属性名的数组：

const jsonStr = '{"name": "钱七", "age": 28, "city": "广州"}';
const data = JSON.parse(jsonStr);
// 获取所有键名
const keys = Object.keys(data);
console.log(keys);  // 输出: ['name', 'age', 'city']

（2）获取嵌套JSON的键名（递归处理）

类似Python，通过递归遍历对象和数组：

function getAllKeys(obj, keysList = []) {
    if (typeof obj === 'object' && obj !== null) {
        if (Array.isArray(obj)) {
            obj.forEach(item => getAllKeys(item, keysList));
        } else {
            Object.keys(obj).forEach(key => {
                keysList.push(key);
                getAllKeys(obj[key], keysList);
            });
        }
    }
    return keysList;
}
const jsonStr = `
{
  "id": 2,
  "info": {"name": "孙八", "hobbies": ["足球", "音乐"]},
  "scores": [88, 92, 76]
}
`;
const data = JSON.parse(jsonStr);
const allKeys = getAllKeys(data);
console.log(allKeys);  // 输出: ['id', 'info', 'name', 'hobbies', 'scores']

（3）检查特定键名是否存在

使用hasOwnProperty()方法判断对象是否包含某个属性：

console.log(data.hasOwnProperty("info"));  // 输出: true
console.log(data.hasOwnProperty("email")); // 输出: false

Java：使用Jackson/Gson库

Java中没有内置的JSON解析类，通常使用第三方库（如Jackson、Gson）处理JSON,以Jackson为例：

（1）获取单层JSON的所有键名

将JSON解析为JsonNode对象，通过fieldNames()方法获取键名迭代器：

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Iterator;
public class JsonKeyExample {
    public static void main(String[] args) throws Exception {
        String jsonStr = "{\"name\": " + "\"周九\", \"age\": 32, \"city\": \"深圳\"}";
        ObjectMapper mapper = new ObjectMapper();
        JsonNode rootNode = mapper.readTree(jsonStr);
        // 获取所有键名
        Iterator<String> fieldNames = rootNode.fieldNames();
        while (fieldNames.hasNext()) {
            String key = fieldNames.next();
            System.out.println(key);
        }
        // 输出: name, age, city
    }
}

（2）获取嵌套JSON的键名（递归处理）

递归遍历JsonNode的子节点：

public static void getAllKeys(JsonNode node, List<String> keysList) {
    if (node.isObject()) {
        Iterator<Map.Entry<String, Json