文档教程【免费下载链接】learnxinyminutes-docsCode documentation written as code! How novel and totally my idea!项目地址https://gitcode.com/gh_mirrors/le/learnxinyminutes-docs点击查看免费下载JSONJavaScript Object Notation是当今最广泛使用的轻量级数据交换格式它以极简的语法同时满足了人类可读、机器可解析的双重要求。本指南以本仓库德语版教程 de/json.md 为骨架结合英文原版 json.md 与其他语言译本逐行拆解 JSON 的完整语法、全部数据类型与格式化自由度并借助仓库的校验工具链说明其文档组织规范帮助读者一次性掌握 JSON 的全部核心能力。为什么说 JSON 是最容易掌握的数据格式正如 de/json.md 开篇所言JSON 是一种“极其简单äußerst einfaches的数据交换格式”因此这份教程也可能是整个 Learn X in Y Minutes 项目中最简单的一篇。JSON 的简单性来源于两个设计取向对人类友好易读易写结构一目了然对机器友好几乎所有语言都提供原生或第三方解析器易解析、易生成。一段 JSON 可以是下列类型的任意值但在实际使用中几乎总是呈现为两种容器结构之一键值对集合{ }在不同语言中对应对象object、记录record、结构体struct、字典dictionary、哈希表hash table、键控列表keyed list或关联数组associative array有序值列表[ ]在不同语言中对应数组array、向量vector、列表list或序列sequence。从源码结构看本仓库对每个主题都维护一份以语言代码命名的目录例如 de/json.md、zh-cn/json.md、es/json.md、ru/json.md全部围绕同一个 JSON 语法核心展开不同之处仅在于键名与解释文字的语言。这本身就印证了 JSON“格式不变、表达随语言而变”的跨语言特性。JSON 支持的全部数据类型JSON 规范只定义了六种数据类型没有日期、没有二进制、没有自定义类——这正是它简单的原因。汇总如下类型示例说明字符串Stringhello、\A quote.\、\u0abe、Newline.\n必须使用双引号包裹支持 Unicode 与转义序列数字Number23、0.11、12e10、3.141e-10、1.23e4整数、小数、指数科学计数法均可对象Object{ key: value }无序的键值对集合数组Array[Values]有序的值列表布尔值true、false仅两个字面量空值null表示“无值”值得注意的细节JSON没有单引号字符串、没有十六进制数字如0x1A、没有NaN或Infinity——这些在其他语言中常见的写法在 JSON 中都是非法的数字不能写成1.或.5这种省略整数/小数部分的风格必须形如1.0或0.5字符串中的\u0abe是 Unicode 码点转义这里对应梵文字符说明 JSON 原生支持任意 Unicode 内容。完整示例一份 100% 合法的 JSON 文档de/json.md 的核心是一段覆盖所有数据类型的完整示例并且刻意不使用任何注释——因为“纯正的 JSON 没有注释”。为了让读者在真实场景中直接可用下文先给出与德语版结构完全一致的完整文档键名保留德语原文含义对照见表格随后逐段拆解。{ schlüssel: wert, alle schlüssel: müssen durch doppelte Anführungszeichen begrenzt werden, zahlen: 0, zeichenketten: Alle Unicode-Zeichen (inklusive \escaping\) sind erlaubt., boolesche werte: true, nullwert: null, große zahlen: 1.2e100, objekte: { kommentar: Die meisten Datenstrukturen in JSON kommen aus Objekten., array: [0, 1, 2, Arrays können Werte jeglichen Datentyps aufnehmen., 4], weiteres objekt: { kommentar: Objekte können verschachtelt werden. } }, quatsch: [ { quellen von kalium: [Bananen] }, [ [1, 0, 0, 0], [0, 1, 0, 0], [0, 0, 1, Neo], [0, 0, 0, 1] ] ], alternative formatierung: { kommentar: ... , die position: des Kommas ist nicht relevant - so lange es vor dem Wert steht. , weiterer kommentar: wie schön , übrigens: Auch die Einrückung ist nicht relevant. , jede: beliebige Anzahl von Leerzeichen / Tabs ist erlaubt., wirklich?:true }, das war kurz: Und, du bist fertig. Du weißt nun (fast) alles über JSON. }同一份结构在中文译本 zh-cn/json.md 中以英文键名出现在西班牙语译本 es/json.md、俄语译本 ru/json.md 中同样如此——所有译本共享完全相同的语法骨架这再次验证了 JSON 语法与自然语言无关。逐段拆解1. 键值对与双引号schlüssel: wert, alle schlüssel: müssen durch doppelte Anführungszeichen begrenzt werden所有键key必须用双引号包裹这是 JSON 与 JavaScript 对象字面量允许裸键名最重要的区别之一。值则可以是任意合法 JSON 类型。2. 数字与布尔值、空值zahlen: 0, boolesche werte: true, nullwert: null, große zahlen: 1.2e1000是整数1.2e100是科学计数法表示1.2 × 10¹⁰⁰说明 JSON 数字支持极大/极小的量级表达布尔值只有true/false且必须小写null表示显式的“无值”与字段缺失在语义上不同。3. 字符串与 Unicodezeichenketten: Alle Unicode-Zeichen (inklusive \escaping\) sind erlaubt.字符串可以包含任意 Unicode 字符示例中的\是转义后的双引号说明字符串内部如需表示引号必须转义。常用转义序列包括\双引号、\\反斜杠、\n换行、\t制表符、\uXXXXUnicode 码点。4. 对象的嵌套objekte: { kommentar: Die meisten Datenstrukturen in JSON kommen aus Objekten., array: [0, 1, 2, Arrays können Werte jeglichen Datentyps aufnehmen., 4], weiteres objekt: { kommentar: Objekte können verschachtelt werden. } }对象是 JSON 结构的核心载体且可以无限嵌套。示例同时展示了对象内部可以包含混合类型数组——[0, 1, 2, 字符串, 4]中数字与字符串并存对象内部还可以继续嵌套对象。5. 数组的任意嵌套quatsch: [ { quellen von kalium: [Bananen] }, [ [1, 0, 0, 0], [0, 1, 0, 0], [0, 0, 1, Neo], [0, 0, 0, 1] ] ]数组可以容纳任意类型的元素包括对象和其他数组。这里演示了典型的“对象数组”与“二维数组”混合结构这正是真实 API 响应中嵌套数据的常见形态例如表格矩阵、树形结构等。6. 格式化的自由度alternative formatierung: { kommentar: ... , die position: des Kommas ist nicht relevant - so lange es vor dem Wert steht. , wirklich?:true }这段刻意展示了 JSON 的宽容性逗号位置只要逗号位于下一个键值对之前即可写在行首同样合法空白与缩进空格、制表符的数量和位置完全不影响解析键与值之间、逗号之后的空白均可随意一行多对jede: ..., wirklich?:true表明同一行可以容纳多个键值对。换言之JSON 的语法约束极少——双引号包裹键、冒号分隔键值、逗号分隔成员、花括号与方括号界定容器仅此而已。关于注释规范之外的事实de/json.md 明确指出纯正的 JSON 没有注释机制因此教程全文刻意保持 100% 合法 JSON。但实践中存在两个普遍事实多数解析器接受 C 风格注释//行注释与/* */块注释在不少解析器中可用如带扩展的解析库、部分配置文件的宽松解析器少数解析器容忍尾随逗号trailing comma即数组最后一个元素或对象最后一个属性之后仍保留逗号。这两者都属于“解析器扩展”而非 JSON 规范内容。为了跨解析器、跨语言的兼容性生产环境中应始终避免使用注释与尾随逗号——这也是本教程坚持零注释、严格合规的原因。英文原版 json.md 对此给出了同样的建议。仓库中的佐证教程如何被组织与校验本项目learnxinyminutes-docs以“代码即文档”为理念见 README.md每个主题的教程都以“合法代码 随行讲解”的形式存在JSON 教程正是这一理念的最小化体现。从仓库结构可以观察到几个支撑点统一的前置元数据每个教程文件顶部都有 YAML frontmatter记录contributors贡献者与translators译者。德语版的贡献者是 Anna Harren 与 Marco Scannadinari译者是 Timm Albers英文原版还额外定义了name: JSON与filename: learnjson.json见 json.md自动化校验工具仓库的 lint/frontmatter.py 会对所有 Markdown 文件的 frontmatter 做严格校验允许的键仅为name、where_x_eq_name、category、filename、contributors、translators并要求 contributor/translator 条目必须是[姓名, URL]形式的二元列表。这意味着每一份教程包括 de/json.md都经过了统一的元数据检查保证全站文档结构一致、可被自动索引多语言覆盖仓库中json.md的译本多达 24 份含 de/json.md、zh-cn/json.md、es/json.md、ru/json.md、fr/json.md、ja/json.md 等全部共享同一语法骨架是学习“同一份 JSON 数据如何用不同语言描述”的绝佳对照材料。从源码结构可以推断本仓库把“JSON 语法本身”视为语言无关的通用知识各语言目录只负责翻译解释文字而示例中的键名则会本地化以贴近母语读者——德语版用schlüssel键、wert值中文版则保留英文键名。无论哪种写法解析结果完全相同。实战建议写出兼容性最佳的 JSON综合教程内容给出可直接落地的四条实践准则键永远使用双引号即使你的目标语言允许裸键名或单引号数字按规范书写整数直接写小数必须两侧都有数字指数用e/E加正负号不在 JSON 中写注释、不留下尾随逗号——若确实需要注释如配置文件场景可约定_comment: ...这样的扩展字段这仍是 100% 合法 JSON利用嵌套但保持适度深度对象与数组的无限嵌套能力很强大但过深的层级会降低可读性与解析性能建议参考示例中 23 层的典型深度。小结从 de/json.md 这份“可能是本项目最简单的教程”可以看到JSON 的全部语法要点其实可以浓缩为双引号键、冒号、逗号、两种容器、六种类型、随意的空白。正因如此它才能成为 Web API、配置文件、日志与跨语言数据交换的事实标准。配合本仓库的英文原版 json.md 与其他语言译本对照阅读你可以在几分钟内完整掌握这一格式的全部规则并写出在任何解析器下都可靠运行的 JSON 文档。赞分享文档教程【免费下载链接】learnxinyminutes-docsCode documentation written as code! How novel and totally my idea!项目地址https://gitcode.com/gh_mirrors/le/learnxinyminutes-docs点击查看免费下载相关推荐JSON 数据交换格式完整语法指南——Learn X in Y Minutes 捷克语教程解析JSON 数据交换格式完整语法指南——Learn X in Y Minutes 捷克语教程解析 JSONJavaScript Object Notation文档教程JSON 数据交换格式完全指南语法类型、嵌套结构与多语言实践Learn X in Y minutes 仓库解析JSON 数据交换格式完全指南语法类型、嵌套结构与多语言实践Learn X in Y minutes 仓库解析 JSONJavaScript Objec文档教程Learn X in Y Minutes 项目文档Learn X in Y Minutes 项目文档 1. 项目目录结构及介绍 learnxinyminutes docs 项目是一个开源文档项目旨在为各种编程文档教程上一篇Apache Arrow GLibC深入指南基于 GObject 的 C 封装、GObject Introspection 与多语言实战下一篇Segment Anything (SAM) 实战指南在 AI-Research-SKILLs 中用点、框与掩码提示实现零样本图像分割创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考