必须按页面内容实时生成title和description，硬编码会导致搜索引擎识别为低质重复内容；静态模板写死元数据会使所有页面共享相同标题和摘要，根本原因是构建逻辑未将页面上下文传入元数据生成环节。
服务端预构建时，title 和 meta name="description" 必须按页面内容实时生成，硬编码或全局 fallback 会导致大量页面共享同一描述，被搜索引擎识别为低质重复内容。
为什么静态模板无法直接写死元数据
预构建（如 Next.js 的 getStaticProps、Nuxt 的 generate、或纯 PHP 模板渲染）本质是批量生成 HTML 文件。若在模板中写死 <title>My Blog</title>，所有页面标题都会一样；同理，若 meta description 来自配置文件而非当前文章正文摘要，搜索结果里几十个链接会显示完全相同的描述文本。
常见错误现象：
- Google 搜索结果中多个 URL 显示相同标题和摘要
- 页面在“站点：yourdomain.com”查询中仅收录首页，其余页面未索引
- 百度站长平台提示“描述信息重复率过高”
根本原因不是技术限制，而是构建逻辑没把「页面上下文」传入元数据生成环节。解决点只有一个：确保每个页面的元数据由其自身数据驱动，而非模板兜底。
立即学习“前端免费学习笔记（深入）”；
PHP 预构建中安全注入元数据的实操要点
使用 PHP 动态生成 HTML 文件时，title 和 description 应从原始内容（如 Markdown 头部、JSON 元数据文件、数据库字段）提取，而非拼接字符串。尤其注意 XSS 风险 —— 用户输入的标题若未转义，直接输出到 <title> 中可能触发执行。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
实操建议：
- 用
htmlspecialchars($title, ENT_QUOTES, 'UTF-8')处理所有写入<title>或meta content的变量 - description 字段应截取前 150 字符，但需在 UTF-8 字节层面截断，避免切开中文字符导致乱码；推荐用
mb_strimwidth($text, 0, 150, '', 'UTF-8') - 避免在
<head>中写<?php echo $description; ?>这类裸输出，统一走封装函数如render_meta_description($post) - 若从 Markdown 解析，优先读取 YAML front matter 中的
title和description字段，而非依赖文件名或目录结构
Webpack + html-webpack-plugin 场景下的 meta 动态化
html-webpack-plugin 的 meta 选项默认只支持静态对象，无法按 chunk 或 entry 动态变化。强行在 webpack.config.js 里写 if/else 判断入口名，会污染构建配置且难以维护。
真正可行的路径是利用插件的 templateParameters 钩子：
- 在
plugins配置中为每个HtmlWebpackPlugin实例传入唯一templateParameters对象，内含该页面专属的title、description、canonical等 - 模板（如
index.ejs）中用<%= htmlWebpackPlugin.options.title %>输出，而非依赖插件内置的meta字段 - 必须禁用插件默认的
meta配置项，否则会与模板中手动写的<meta>标签重复 - 对
charset和viewport这类全局一致的元数据，仍可保留在meta配置里，但业务相关元数据一律交由模板控制
容易被忽略的 canonical 和 hreflang 注入时机
预构建时，<link rel="canonical"> 必须指向当前页面的**绝对规范 URL**，而不是相对路径或开发环境地址。若构建脚本未注入 BASE_URL 环境变量，生成的 canonical 可能是 http://localhost:3000/post/abc，上线后会被搜索引擎当作无效链接丢弃。
hreflang 同理：多语言站点若靠构建时读取 locales.json 生成 <link rel="alternate" hreflang="zh-CN">，必须确保每个语言版本的 HTML 文件都包含完整 hreflang 集合，且互为反向引用 —— 缺一不可，否则 Google 会忽略整个 hreflang 声明。
这两个标签不像 title 那样影响点击率，但一旦出错，直接导致搜索引擎无法正确归并重复内容或分发地域流量，修复周期远长于改描述文案。
