基于JSON-LD的HTML结构化数据标记与搜索优化技巧
JSON-LD结构化数据标记需直出在HTML的或顶层，避免嵌套和动态插入，服务端渲染时输出，禁用async等属性。生成JSON时使用JSON_UNESCAPED_UNICODE等参数防转义。Article类型需满足headline、datePublished（ISO8601格式）、author对象等要求。验证时禁用浏览器插件，确保绝对URL和正确@conte
说到结构化数据，大多数人真正困惑的并非“要不要添加”，而是“添加后为何毫无效果”。JSON-LD 表面上看只是一段简单的脚本，但 Googlebot 对它有非常严格的要求——它不会执行任何 JavaScript，也不解析 DOM，只会死磕原始 HTML 中直接输出的纯脚本块。因此，这条规则必须牢记：JSON-LD 只能直接放在 或 中，绝对不能嵌套在 、、 这类标签里。不少人在 Search Console 中看到“未检测到结构化数据”，翻源码明明存在，一查才发现是被框架动态插入（如 Next.js 的 useEffect），或者 CMS 模板无意间将其塞进了 ——这些都属于无用功。
如果你的项目采用 SSR 或静态站点（Hugo、Jekyll 等），天然具备优势，直接写进模板即可。而 React/Vue 项目则必须确保脚本在服务端渲染阶段就输出，千万不要拖到客户端挂载。另外还有一条铁律：async、defer 或 type="module" 这类属性一律不能加，加了浏览器会直接跳过解析，等于白写。
JSON-LD 到底该放在
前文已经明确：两者都可以，但前提是直接输出且不被嵌套。常见的翻车原因是框架把脚本“藏”起来了。请记住：Googlebot 只扫描最外层的