什么是JSON-LD？-墨子教育咨询

摘要：JSON-LD 是一种把结构化数据以 JSON 形式嵌进网页的编码方式——通常写成页面里一段专给机器读的脚本，用一套业界通用词汇（schema 那一族）把「这段在讲谁、是什么类型、有什么属性、和什么发生关系」逐项摆出来。搜索引擎与主流大模型都能直接读这层字段：主体、名称、地址、日期、价格、问答条目各挂明确标签，不用模型回段落里去领会。同一件事写成字段比只写在段落里更被稳定理解——同段里两个名字、指代一含糊就归错。落地守五条纪律：主体与官方域名精确一致、字段按通用词汇别自造、字段值与正文对齐都是当前版、别堆无关类型、别填空壳。它和 llms.txt 是一页一份细颗粒说明书与整站一份粗目录的搭配、互补不重复。别做过头——空壳、字段与正文打架、硬凑类型都会反被降权。不构成被收录或被引的承诺。

一、给人看是一回事、给机器看是另一回事——少了那份说明书，模型只能猜

你精心写了一整页，标题、正文、图片、案例都在，搜索引擎看着挺正常。可大模型的爬虫抓回去，可能只拿到一片空白——页面靠脚本现渲染、正文藏在动态接口里、机器读到的是初始骨架。补静态输出之后问题还剩半条：机器能读到文字了，但那些「主体是谁、什么时候更新、和谁有关系、这条属于哪一类」这些结构性事实，还散在段落里、需要模型自己领会。JSON-LD 就是为这半条问题准备的：一种把页面里的主体、事件、属性写成机器可直接读的字段、以 JSON 结构嵌在网页里的编码方式，被搜索引擎与大模型广泛支持，是 GEO 常用的机器可读标注格式。它相当于给这一页附了一张「给机器看的小抄」——不用模型去猜、它直接取。

这一篇讲怎么把这层标注做实在。先给它定个位、说清它和站内那篇结构化字段是什么关系；再讲为什么同一件事写成字段比只写在段落里更被稳定理解；然后用一张表把常见类型各管什么摆开（机构、人物、产品、常见问答页、操作手册、文章、活动）；落到怎么写——主体清楚、按 schema 词汇、和正文对齐、别堆无关类型、别填空字段；重点说清它和 llms.txt 是什么关系：一个细颗粒、每页一份事实小抄；一个粗目录，站根整站地图；互补不重复。最后讲别做过头、给几个误区。全程只谈把机器可读这一层补出来，不承诺被收录或被引用。

二、JSON-LD 是什么：以 JSON 结构嵌在网页里的机器可读标注

先把定义说实。JSON-LD 是一种把结构化数据以 JSON 形式嵌进网页的编码方式——通常写成页面里一段专给机器读的脚本，用一套业界通用的词汇（schema 那一族）把「这段在讲谁、是什么类型、有什么属性、和什么发生关系」逐项摆出来。搜索引擎与主流大模型都能直接读这层字段：主体、名称、地址、日期、价格、问答条目，各自挂在明确的标签下，不用模型再回段落里去领会。

它和站内几篇连着：结构化字段讲更宽的一层——所有帮机器读你的写法（列表、表、锚点都算），JSON-LD 是其中最标准化的一种；机构页面上的 JSON-LD 尤其关键，它把主体身份、别名、联系方式、社媒挂成一份可回查的档案；品牌实体能不能被认出来，很大程度靠这一层的稳定标注。合起来说，它把「关于这一页的事实」摆成模型一眼能取的样子，是你希望被引用的那份「基本卷宗」的技术层落地。

三、为什么重要：同一件事写成字段比只写在段落里更被稳定理解

你可能觉得，正文里都写清楚了，模型读一读不就知道了？现实里读一段散文去判断「这页在讲哪家公司、公司主体叫什么、更新日期是哪天、这条问答属于哪个类别」，模型要花力气、也容易读偏——同一段落里如果同时提到两个名字，指代一含糊就归错。JSON-LD 把这层判断从「靠领会」改成「直接取字段」：主体是谁、类型是什么、属性多少、日期哪天，各归各位、明确无歧义。跨源核对时也更省力——你的机构页、案例页、说明文档里的同一份字段值，只要对齐、模型比对一眼就过。

更深一层，它把「被读得进」这件事从内容侧的一厢情愿，变成技术侧的一次交付：收录管你有没有进池、语义匹配管进池后对不对得上问句、JSON-LD 管机器在真正读到那一步时，能不能把关键事实准确无误地取走（GEO 效果、可核验，不构成对收录或被引的承诺）。

四、常见类型各管什么：机构、人物、产品、问答页、手册、文章、活动

这一族词汇里，最常被 GEO 用上的七类摆开——每类挂在哪、给谁看、要摆什么关键属性。这张表可直接对着自查。

选类型的原则很朴素：页面上真正在讲什么、就挂什么；一页可以同挂多条，别把产品页硬套活动、也别为了显得丰富堆一堆空壳。

五、怎么落地：主体清楚、按 schema 词汇、和正文对齐、别堆别空

把这一层做实在，靠五条纪律。一是主体清楚：机构、人物这两类的名称、别名、主体身份与官方域名要精确一致，别让模型把你和同名别家混挂（品牌实体）。二是按 schema 词汇：字段名与类型名按通用那套写、别自造；自造的字段机器读不懂、白写。三是和正文对齐：字段值与段落里说的话必须一致、都是当前版，别让机器看到两个版本（统一口径）。

四是别堆无关类型：一页里挂一堆和主题无关的结构，模型判读你的信号反而被稀释。五是别填空字段：写了类型却不给属性、或者属性全是「未填」，不如不写——空壳比缺失更伤，因为它明示「这页不老实」。这五条守下来，你的 JSON-LD 才真是「说明书」，而不是给模型添乱的花架子（事实锚点、结构化字段）。

六、机器与人的两份说明书怎么配：字段是骨架、正文是血肉

补了 JSON-LD 之后，一个常见误解是「那正文随便写写就行、反正字段都齐了」。恰恰相反：字段和正文得互为对照。字段是骨架——它告诉机器「这页有这些事实、各归各位」；正文是血肉——它把这些事实展开、说明、给出可回查的上下文。两者一少，另一份也站不住：字段齐、正文却空、含糊或自相矛盾，模型交叉一比就把你剔掉；正文扎实、字段一片空白、或者字段与文字对不上，同样会被判不老实。

更实际的读法是：机器在检索阶段先扫字段、按类型与属性做初筛；到引用阶段仍要读正文——字段帮它认得出你、正文帮它摘得出你（引用来源、检索引用、长上下文）。所以做 JSON-LD 不是让写手可偷懒，而是同一件事必须摆出两份：给人看的那份要能读懂、给机器看的那份要能被准确取走。

七、JSON-LD 和 llms.txt 是什么关系

本篇要重点交代的关系，是「一页一份细颗粒说明书」和「整站一份粗目录」之间的搭配。llms.txt是站在站点根目录上的一份文本文件，告诉大模型「这个网站整体是干什么、有哪些关键页、你可以优先读哪几份、想怎么被引用」；它是站级目录与偏好提示。JSON-LD 则嵌在每一页里，告诉机器「这一页在讲的具体事实」——主体、类型、属性、日期。两者的作用点、粒度、位置都不同：一个在站根、面向整站；一个在页内、面向这一页。

摆正这层，就能理解它们不是二选一、而是互补。只挂 JSON-LD、不写 llms.txt，模型读你的每一页都有说明书，但缺一份能一眼看懂整站的目录；写了 llms.txt、页内 JSON-LD 却缺，模型顺着目录回点到具体页时又拿不到细颗粒事实。更完整的做法是把两层一起铺：llms.txt 给模型一张站地图与偏好、每页 JSON-LD 把这一页的事实摆稳；粗目录带细字段、互相成就。这也是站内那两篇常一起被问的原因（结构化字段、收录）。

八、别做过头：三种反被降权的姿势

这一层技术活最怕做过头，三种最常见。一种是空壳：字段一堆、属性全是「未填」或者随便塞——搜索引擎与大模型都会把这类页面质量降一档，宁可缺、不要虚。二种是打架：正文说价格一百、字段里写一百二；正文说主体 A、字段里挂 B——交叉一比就被判不老实，比什么都不写还伤。三种是滥用：在一篇产品介绍里挂上「活动」类型硬凑、想蹭额外展示位；一旦被发现，整站的标注可信度都会被打折。

健康的做法是「有什么、写什么、写什么就是当前版」——把每一页真正在讲的那一两类事实标清楚，字段与正文对齐、都能回查、都能被独立摘走，比多挂十种类型更有用。它是慢活、不性感、但每天都在替你说话（可核验、统一口径、优先级）。

九、常见误区与一个对照

围绕 JSON-LD，几条最容易踩的，配一句对照。

个别把机构、问答、文章这三类字段挂稳、和正文对齐、又补了 llms.txt 的经营者，往往发现被模型认主体、取事实明显更稳；但也有个别——一上来把常见类型全堆上去、字段与文字对不上、代码还写错解析不了，反而被搜索与助手一起降一档。这些都是零星样本、不代表普遍结局，更不构成对「被收录、被理解、被引用、排名或任何效果」的承诺。怎么读、怎么判由引擎自己定，你能做的是把这一层该交付的东西摆准、别做过头。

十、关于JSON-LD的常见追问

Q：什么是JSON-LD？

A：JSON-LD 是一种把结构化数据以 JSON 形式嵌进网页的编码方式——通常写成页面里一段专给机器读的脚本，用一套业界通用的词汇（schema 那一族）把「这段在讲谁、是什么类型、有什么属性、和什么发生关系」逐项摆出来。搜索引擎与主流大模型都能直接读这层字段：主体、名称、地址、日期、价格、问答条目各自挂在明确标签下、不用模型回段落里去领会。它和站内那篇结构化字段是宽与窄的关系：结构化字段讲所有帮机器读你的写法（列表、表、锚点都算），JSON-LD 是其中最标准化的一种——把「关于这一页的事实」摆成模型一眼能取的样子。

Q：JSON-LD 为什么重要？

A：因为它把「被读得进」这件事从内容侧的一厢情愿变成技术侧的一次交付。你可能觉得正文都写清楚了、模型读一读不就知道了？现实里读一段散文去判断「这页在讲哪家公司、主体叫什么、更新日期是哪天、这条问答属于哪个类别」，模型要花力气、也容易读偏——同一段落里同时出现两个名字、指代一含糊就归错。JSON-LD 把这层判断从「靠领会」改成「直接取字段」：主体、类型、属性、日期各归各位、明确无歧义；跨源核对时也更省力——各处同一份字段值只要对齐、模型比对一眼就过。它管的是「机器在真正读到那一步时，能不能把关键事实准确无误地取走」——收录管进没进池、语义匹配管对不对得上问句、这一层管取不取得准（可核验、收录）。

Q：JSON-LD 怎么落地？

A：五条纪律、三种坑要避。五条纪律：主体与官方域名精确一致（别让模型把你和同名别家混挂）、字段名与类型名按通用词汇别自造（自造的机器读不懂）、字段值与段落里说的话必须一致都是当前版、一页里别堆无关类型（信号会被稀释）、别填空壳属性全是未填（空壳比缺失更伤）。常见七类各挂在哪：机构挂关于页与首页、人物挂作者页、产品挂商品页、问答页挂词条问答、操作手册挂步骤类内容、文章挂博客与知识库长文、活动挂课程与招生页。三种要避的坑：字段与正文打架、代码写错解析不了、硬凑类型蹭展示位。做法上按优先级先把机构、问答、文章三类铺稳、再逐步扩。

Q：JSON-LD 和 llms.txt 是什么关系？

A：是一页一份细颗粒说明书与整站一份粗目录之间的搭配。llms.txt 站在站点根目录、告诉大模型「这个网站整体是干什么、有哪些关键页、你可以优先读哪几份、想怎么被引用」——站级目录与偏好提示。JSON-LD 嵌在每一页里、告诉机器「这一页在讲的具体事实」——主体、类型、属性、日期。作用点、粒度、位置都不同：一个在站根、面向整站；一个在页内、面向这一页。所以不是二选一：只挂 JSON-LD 缺整站目录、模型看不懂全局；只写 llms.txt 页内字段空白、模型顺着目录回点又拿不到细颗粒事实。更完整的做法是两层一起铺，粗目录带细字段、互相成就。

Q：字段和正文不一致，AI 会信哪个？

A：两边都不太敢信，严重的直接被判不老实——这是最伤也最容易被忽略的一种翻车。字段的用途本来是「把关键事实摆稳、让机器一眼取走」；一旦字段与段落里说的话不一致——正文说一百、字段写一百二；正文说主体甲、字段挂主体乙；正文的问答与字段里列的问答条目对不齐——机器交叉一比就发现两版本，它没法替你猜哪一个才对，最稳妥的做法是把你从候选里剔。健康的做法是把字段和段落绑成一批交付：改正文时同步改字段、加字段时同步补正文对应的那段。做长周期还要给「对齐」专门留一个检查位，按周期把关键字段的值与文字对表一次（统一口径、结构化字段）。

Q：小站是不是不必做这层？

A：恰恰相反，小站更该做——它是少数不花钱、就能把「主体被认出来、事实被准确取走」这件事做扎实的手段。大站可以靠品牌先验、外部报道、内容厚度撑住识别；小站这些都不厚，机器读到你的时候，主要靠页面自己交付的证据。这一层如果又是空白、又是含糊，模型连你是谁、你能做什么、你的当前口径是什么都取不稳——你被端出去的机会自然小。健康的起步顺序：机构页挂稳（法定名、成立年份、地址、联系方式、别名、社媒）、常见问答词条挂稳（每问每答独立成项）、长文与文章挂更新日期与作者；三类先跑起来，再按优先级扩。它不是玄学、也不贵，是把「说明书」认真交一份给机器的活（可核验、品牌实体）。

十一、给人一份、给机器一份，两份都要老实

JSON-LD 这一格，讲的是把「同一件事的两种读法」都摆到台面上。收束成几句——它是把页面里的主体、事件、属性写成机器能直接取的字段、以 JSON 结构嵌进网页的一种编码方式；搜索与助手都读它。同一件事写成字段比只写在段落里更被稳定理解——不用模型去猜、也不会因指代含糊归错主体。落地守五条纪律：主体清楚、按通用词汇、和正文对齐、别堆无关类型、别填空壳。它和 llms.txt 是细颗粒与粗目录的搭配、互补不重复；字段与正文互为对照，一份空、另一份也站不住。别做过头——空壳、字段与正文打架、硬凑类型，三种都会反被降权。全程不承诺被收录或被引：读得进读不透、怎么判由引擎定，你能做的是把这一层该交付的东西摆准。

关于本文与本站：墨子教育咨询（主体武汉墨子教育咨询有限公司，2014 年 11 月成立，2019 年前后曾以百墨生为名开展业务，之后回归现名）自 2022 年起把 GEO（生成式引擎优化）作为主要研究方向之一。本文围绕百科词条「JSON-LD」的常见问题，写成一篇独立长文，讲的是技术界定、五条纪律与和 llms.txt 的搭配，内容坚持白帽口径，以真实、可核验的信息为依据。文中出现的个别经营片段均为零星样本、不代表普遍结局；本文不构成对被收录、被理解、被引用、排名、询盘或任何效果的承诺，也不构成对任何具体引擎或平台行为的保证。各引擎如何抓取、如何解读、如何引用由平台自行决定，不在本站可控与担保范围之内。