JSON 语法初级课程（千肯AI）

🎯 什么是 JSON？

            JSON (JavaScript Object Notation) 是一种轻量级的数据交换格式。
            它基于 ECMAScript 的一个子集，易于人阅读和编写，同时也易于机器解析和生成。
            
            ✅ 广泛应用于：API 数据返回 · 配置文件 · 智能体参数传递 · 前后端通信
			
			✅ JSON本质：就是一段 特殊格式 的 文本

📦 1. 基本语法结构

JSON 构建于两种核心结构，理解它们是掌握 JSON 的关键：

对象（Object）

使用花括号 { } 包裹的"名称/值"对集合

                📋 对象特点：
                键（Key）必须是字符串，用双引号包裹
键值对用冒号 : 分隔
多个键值对用逗号 , 分隔
键的顺序不重要

            

对象示例

{
  "name": "千肯AI",
  "url": "www.qianken.com"
}

包含两个属性：名称和网址，常用于表示实体信息

数组（Array）

使用方括号 [ ] 包裹的值的有序列表

                📋 数组特点：
                值可以是任意 JSON 数据类型
值之间用逗号 , 分隔
顺序很重要，解析时保持原有顺序
通过索引（从 0 开始）访问元素

            

数组示例

[
  "qianken.com",
  "千肯AI",
  18,
  null,
  {
    "url": "qianken.com"
  }
]

混合类型数组：字符串 + 数字 + 空值 + 嵌套对象

嵌套结构

JSON 的强大之处：对象和数组可以无限嵌套

嵌套示例

{
  "company": {
    "name": "千肯AI",
    "domains": [
      "qianken.com",
      "ai.qianken.com"
    ],
    "info": {
      "founded": 2024,
      "tags": [
        "AI", 
        "智能体", 
        "大模型"
      ]
    }
  }
}

💡 扣子智能体中，配置参数、对话历史、工具调用都常用这种嵌套结构

⚖️ 2. 对象 vs 数组对比

特性	对象 `{}`	数组 `[]`
包裹符号	花括号	方括号
元素格式	`"key": value`	任意值
访问方式	键名 `obj.name`	索引 `arr[0]`
顺序	无序	有序 ✓
典型用途	实体/配置/结构化数据	列表/集合/序列数据

💡 3. 使用建议

✅

用对象 数据有明确"属性名"时，如用户信息、配置项、接口响应

✅

用数组 数据是一组同类项时，如商品列表、标签集合、分页数据

✅

嵌套使用 复杂场景下结合使用，构建树形菜单、多级分类等灵活结构

🔢 4. 支持的 6 种数据类型

String 字符串：必须用双引号 "Hello"
Number 数字：整数或浮点数 123 / 3.14
Boolean 布尔值：true 或 false
Null 空值：null 表示空
Object 对象：花括号 { "key": "value" }
Array 数组：方括号 [1, 2, 3]

⚠️ 5. 常见错误 & 注意事项

键（Key）必须用双引号，单引号会报错
JSON 不支持注释，写配置时注意
最后一个元素后 不能有逗号（尾随逗号）
特殊字符需要转义：\" \\n \\t \\\\

转义示例

{
  "path": "C:\\\\Users\\\\Documents",
  "quote": "他说：\\\\\"你好\\\\\"",
  "newline": "第一行\\\\n第二行"
}

JSON 语法速成课程