先有地图 / Map First

一种让人能读懂、机器也能解析的数据格式——软件世界里最通用的"数据普通话"。

它到底指什么？

JSON（JavaScript Object Notation）是一种写数据的格式。它长这样：

{
  "name": "我的项目",
  "version": "1.0.0",
  "private": true
}

花括号 {} 装一组键值对，方括号 [] 装一个列表，值可以是文字、数字、布尔值、或者嵌套的对象和列表。就是这么简单——没有复杂的语法，没有隐藏的规则。

几乎每个前端项目的根目录都有一个 package.json 文件——它用 JSON 格式记录了项目的名称、依赖列表和可执行的脚本命令。

当你的程序调用一个 API 时，服务器返回的数据通常也是 JSON 格式——你的代码拿到这段 JSON，从中提取需要的字段，然后展示到界面上。

各种工具的配置文件——比如 tsconfig.json、biome.json——同样用 JSON 来存储设置项。

JSON 对格式的要求很严格：所有的键名必须用双引号包裹，末尾不能有多余的逗号，不支持注释。如果你手动编辑 JSON 文件时不小心漏了一个逗号或多加了一个逗号，程序就会报错说"JSON 解析失败"。好消息是 AI 和编辑器都能帮你快速定位这些格式错误。