第八章 · 文档头
head、SEO 与性能:写给机器看的第一屏
用户看不见 head,但浏览器、搜索引擎、社交平台和各种阅读器都先读它。 这一章把文档头里的元素分成「必须、推荐、按需」三层,再谈分享卡片、结构化数据、 资源提示与脚本加载顺序。最后附上一份可以直接抄用的完整模板。
head 全景:给机器读的第一屏
<head> 是文档的「第一屏」,只不过它给机器看:浏览器在这里读取编码、视口、标题、
样式表、脚本与各种声明。除了 <title> 会显示在标签页上,其余内容都不出现在正文里。
它像一封写在正文之前的说明信,语气平静,却决定了整页如何被理解、索引与呈现。
浏览器解析 head 时是宽容的:遇到 meta、link、title、
style、script、noscript、template 与
base,会按各自规则处理;遇到明显属于正文的元素(比如 div、
p),会提前结束 head,把它们挪进 body。所以「写在 head 里」并不等于
「它会被当成元信息」。
顺序上有两个硬约束:charset 必须出现在文档前 1024 字节内,否则浏览器可能已经
用错误编码开始解析;viewport 越早越好,让移动端在布局前就知道宽度。
其余标签的顺序影响不大,但把 title、description、
canonical 放在前面,便于人阅读与工具抓取。一个文档只有一个 head,
且必须紧跟 <html> 开始标签。
| 层级 | 元素 | 说明 |
|---|---|---|
| 必须 | meta charset、meta viewport、title |
缺一个,中文、移动端或标签页就会出问题 |
| 推荐 | description、canonical、icon、theme-color、Open Graph |
影响搜索摘要、分享卡片与浏览器外观 |
| 按需 | robots、hreflang、manifest、preload、JSON-LD、color-scheme |
按站点类型与性能目标逐项添加 |
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<!-- 编码:必须在前 1024 字节内 -->
<meta charset="UTF-8">
<!-- 视口:移动端布局的前提 -->
<meta name="viewport" content="width=device-width, initial-scale=1">
<!-- 标题:搜索结果与标签页的第一行字 -->
<title>页面主题 · 站点名</title>
<!-- 描述:搜索结果的摘要,不直接参与排名 -->
<meta name="description" content="一句话说清这个页面能解决什么问题。">
<!-- 规范化地址:告诉搜索引擎哪个 URL 是正本 -->
<link rel="canonical" href="https://example.com/page">
<!-- 站点图标 -->
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<!-- 样式表:会阻塞渲染,尽量放在 head 靠前位置 -->
<link rel="stylesheet" href="/assets/css/style.css">
</head>
<body>
<h1>页面主题</h1>
</body>
</html>
把业务数据、大段 JSON 或调试信息堆进 head,会拖慢首个字节的解析,也会让模板难以维护。head 只放「声明」,数据交给正文与接口。
基础元信息:编码、视口、标题与配色
charset 与 viewport 是最不起眼、却最容易造成事故的两个标签。
编码声明缺失,或服务器返回了错误的 Content-Type,中文就会变成乱码;
viewport 缺失,手机浏览器会按 980px 的虚拟宽度渲染再缩小,字小得像注释。
viewport 的 content 里,width=device-width 让布局宽度等于设备宽度,
initial-scale=1 设定初始缩放。若要做全面屏适配,加
viewport-fit=cover,再用 CSS 的 env(safe-area-inset-*)
给刘海与手势条留出空间。不要用 user-scalable=no 禁止缩放,
那会伤害低视力用户,也可能被无障碍审计判为不合格。
title 的写法:先写页面主题,再写站点名,用间隔号或短横线分隔;
中文建议控制在 20 到 30 字以内,搜索结果大约在 30 个汉字左右截断。每页的 title 应该唯一,
不要用「首页」「详情页」这种没有信息量的词。
description 不是排名因素,但它是搜索结果的「广告文案」。
写法是「这个页面讲什么,对谁有用」,70 到 120 字为宜;不要堆关键词,
也不要每页复制同一段。它会被搜索引擎按查询词截取或改写,所以开头就要说重点。
theme-color 让移动端浏览器的地址栏染上品牌色,可以配合
media="(prefers-color-scheme: dark)" 给深色模式单独设定。
color-scheme 告诉浏览器这个页面支持哪些配色,浏览器会据此调整表单控件、
滚动条与默认背景;写 light dark 表示两者都支持,
写 only light 则明确拒绝深色模式。
author 与 generator 属于可写可不写,
generator 会暴露建站工具与版本,静态站点可以选择省略。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
<meta name="color-scheme" content="light dark">
<meta name="theme-color" content="#faf7f0">
<title>一篇关于纸与光的短文</title>
<meta name="description" content="用一页没有图片的正文,观察 viewport 与排版的关系。">
<style>
body { margin: 0; padding: 24px; background: #faf7f0; color: #3a3631; font-family: system-ui, sans-serif; line-height: 1.85; }
.wrap { max-width: 34em; margin: 0 auto; }
.tag { font-size: 12px; letter-spacing: .14em; color: #587768; }
h1 { font-size: 22px; margin: 8px 0 12px; }
p { font-size: 14px; color: #6b6459; margin: 8px 0; }
</style>
</head>
<body>
<div class="wrap">
<p class="tag">META · 基础</p>
<h1>纸面上的光</h1>
<p>这一页没有图片,也没有脚本。所有信息都写在 head 里,正文只是一小段文字。</p>
<p>改变窗口宽度,文字会随视口重新排列——这就是 viewport 的作用。</p>
</div>
</body>
</html>
<!-- 浅色模式与深色模式分别指定主题色 -->
<meta name="theme-color" content="#faf7f0">
<meta name="theme-color" content="#2c332e" media="(prefers-color-scheme: dark)">
<!-- 声明页面支持浅色与深色 -->
<meta name="color-scheme" content="light dark">
<!-- 声明页面只支持浅色,避免浏览器强行反色 -->
<!-- <meta name="color-scheme" content="only light"> -->
<meta name="author" content="拾光 HTML">
<!-- <meta name="generator" content="某个建站工具"> -->
SEO 基础:把话说清楚,其余交给内容
SEO 不是一个 meta 标签能解决的事,但有几个标签确实在「告诉搜索引擎如何看待这个页面」。 它们的作用是消除歧义,而不是操纵排名。
canonical 声明这个页面的规范地址。当同一份内容可以通过多个 URL 访问
(带查询参数、带 www、http 与 https 并存),用绝对地址指向正本,避免权重被分散。
它应当是自引用的:每个页面都指向自己。不要把全站页面都 canonical 到首页,
那会让其他页面从索引里消失,是常见的灾难级配置。
robots 控制单个页面的抓取与索引行为。noindex 表示不要把这一页
放进搜索结果,nofollow 表示不要沿着页面里的链接继续。
要区分 robots.txt 与 robots meta:前者阻止爬虫访问,后者阻止已抓取的内容被索引;
如果页面被 robots.txt 挡住,爬虫读不到 noindex,反而可能因为外链被索引成「无摘要」的结果。
需要展示大图时,加上 max-image-preview:large。
hreflang 用于多语言、多地区页面,告诉搜索引擎「这一页的法语版本在另一个地址」。
它需要互相指认(A 指向 B,B 也指向 A),并用 x-default 指向语言选择页
或默认版本。漏掉互相指认,等于白写。
站点图标建议同时提供 SVG 与 ICO:SVG 体积小、任意缩放清晰,现代浏览器优先;
ICO 作为旧环境兜底。iOS 的 apple-touch-icon 建议 180×180,且不要透明背景,
否则会被填成黑色。最后仍然是内容本身:一个 h1、层级清晰的 h2 与 h3、
有信息量的链接文字、准确的图片 alt,这些比任何标签都重要。
| 指令 | 含义 | 常见场景 |
|---|---|---|
noindex | 不把页面放进搜索结果 | 后台、测试页、搜索结果页 |
nofollow | 不追踪页面内链接 | 评论区、不可信内容 |
noarchive | 不提供网页快照 | 时效性强或涉及隐私的页面 |
nosnippet | 不显示文本摘要 | 付费内容、需要点击才可见的内容 |
max-image-preview:large | 允许搜索结果展示大图 | 图片为主的内容站 |
max-snippet:[数字] | 限制摘要长度 | 精细控制展示范围 |
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>山间笔记:把日子过慢一点 | 拾光 HTML</title>
<meta name="description" content="一篇关于慢下来的短文,示范标题与描述的写法,以及 canonical 与 robots 的基本配置。">
<link rel="canonical" href="https://example.com/notes/slow-down">
<meta name="robots" content="index, follow, max-image-preview:large">
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<style>
body { margin: 0; padding: 24px; background: #faf7f0; color: #3a3631; font-family: system-ui, sans-serif; line-height: 1.9; }
article { max-width: 34em; margin: 0 auto; }
h1 { font-size: 21px; margin: 0 0 6px; }
.time { font-size: 12px; color: #978d7f; letter-spacing: .04em; }
p { font-size: 14px; color: #6b6459; }
</style>
</head>
<body>
<article>
<h1>山间笔记:把日子过慢一点</h1>
<p class="time"><time datetime="2026-11-16">2026 年 11 月 16 日</time></p>
<p>雾还没有散,石阶上有昨夜留下的水痕。</p>
<p>这些标签不会出现在页面上,但它们决定了这页文字被谁、以什么样子看见。</p>
</article>
</body>
</html>
<link rel="canonical" href="https://example.com/guide/html-meta">
<link rel="alternate" hreflang="zh-CN" href="https://example.com/zh/guide">
<link rel="alternate" hreflang="en" href="https://example.com/en/guide">
<link rel="alternate" hreflang="x-default" href="https://example.com/guide">
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="apple-touch-icon" href="/apple-touch-icon.png" sizes="180x180">
社交分享:一张卡片的三行字与一张图
链接被分享到社交平台时,那张卡片由页面里的元信息决定。Open Graph 是早年提出、
如今被广泛采用的协议,四个必备字段是 og:title、og:description、
og:image、og:url;再加上 og:type 与
og:site_name,卡片就完整了。
og:image 必须是绝对地址,建议 1200×630(约 1.91:1),文件控制在 5MB 以内,
用 JPG 或 PNG。图片里的重要文字要留出安全边距,因为不同平台会裁剪成方形或竖版;
文字太小,在手机上也看不清。og:image:alt 给读屏用户与加载失败时一个交代。
Twitter(现 X)有自己的 Card 体系,常用 summary_large_image;
twitter:card、twitter:title、twitter:description、
twitter:image 与 Open Graph 有重叠,但为了兼容建议两套都写。
LinkedIn、Slack、微信等大多读取 Open Graph,字段齐全就不会出大错。
调试很重要:分享出去发现没图、标题不对,多半是平台缓存。
各家的分享调试工具都能强制重新抓取,先在可公开访问的地址上测试,
localhost 是抓不到的。还有一个细节:og:url 应与
canonical 一致;若页面会为 A/B 测试改标题,记得同步更新。
分享卡片是别人第一次看见你的方式,值得多花十分钟:选一张安静的封面, 写一句准确的描述,删掉最后那个多余的感叹号。
<meta property="og:type" content="article">
<meta property="og:site_name" content="拾光 HTML">
<meta property="og:title" content="head、SEO 与性能">
<meta property="og:description" content="写给机器看的第一屏:从编码到分享卡片。">
<meta property="og:url" content="https://example.com/meta.html">
<meta property="og:image" content="https://example.com/cover.jpg">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="米色纸面上的标题与细线">
<meta property="og:locale" content="zh_CN">
<meta property="article:published_time" content="2026-11-16T09:30:00+08:00">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@example">
<meta name="twitter:title" content="head、SEO 与性能">
<meta name="twitter:description" content="写给机器看的第一屏。">
<meta name="twitter:image" content="https://example.com/cover.jpg">
<meta name="twitter:image:alt" content="米色纸面上的标题与细线">
<style>
.share-card { max-width: 460px; border: 1px solid #e7dece; border-radius: 14px; overflow: hidden; background: #fffdf9; font-family: system-ui, sans-serif; }
.share-art {
aspect-ratio: 1200 / 630; display: grid; place-items: center;
background: linear-gradient(135deg, #e9f0ea, #f8ece6);
color: #587768; font-size: 13px; letter-spacing: .18em;
}
.share-body { padding: 12px 15px 15px; border-top: 1px solid #e7dece; }
.share-host { font-size: 11px; color: #978d7f; letter-spacing: .06em; text-transform: uppercase; }
.share-title { margin: 4px 0 4px; font-size: 15px; font-weight: 600; color: #3a3631; }
.share-desc { margin: 0; font-size: 12.5px; color: #6b6459; line-height: 1.7; }
</style>
<div class="share-card">
<div class="share-art">1200 × 630 · OG IMAGE</div>
<div class="share-body">
<p class="share-host">example.com</p>
<p class="share-title">head、SEO 与性能</p>
<p class="share-desc">写给机器看的第一屏:从编码到分享卡片。</p>
</div>
</div>
结构化数据:用 JSON-LD 介绍这一页
结构化数据是给搜索引擎的「内容说明书」。同样一篇文章,人看到标题、作者、时间, 机器却只能靠猜;用 schema.org 的词汇标注之后,机器就能确认「这是一篇 2026 年 11 月 发布的文章,作者是谁,配图是哪张」,从而生成更丰富的搜索结果。
三种写法里,JSON-LD 是搜索引擎推荐的方式:它是一段独立的 JSON,放在
<script type="application/ld+json"> 里,不污染正文标记,
改版时也不容易破坏。Microdata 与 RDFa 把标注写进 HTML 属性,维护成本更高,
适合已经存在大量标记的老项目。
Article 类型常用字段:headline、description、
image、datePublished、dateModified、
author(Person 或 Organization)、publisher、
mainEntityOfPage。时间用 ISO 8601 并带上时区。
Product 需要 name、image、description、
brand 与 offers;offers 里至少有 price、
priceCurrency、availability,价格要与页面上显示的一致。
BreadcrumbList 用 itemListElement 数组描述层级,
每一项有 position、name、item(绝对 URL),
它能让搜索结果里的路径变成可点击的面包屑。
两条原则:标注必须与页面上真实可见的内容一致,不要为了富媒体结果虚构评分与价格; 用富媒体结果测试与 Schema 标记验证工具检查,前者看搜索引擎是否支持这种类型, 后者看语法与词汇是否规范。
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "head、SEO 与性能",
"description": "写给机器看的第一屏。",
"image": "https://example.com/cover.jpg",
"datePublished": "2026-11-16T09:30:00+08:00",
"dateModified": "2026-11-16T10:00:00+08:00",
"author": {
"@type": "Person",
"name": "林晚"
},
"publisher": {
"@type": "Organization",
"name": "拾光 HTML",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
},
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/meta.html"
}
}
</script>
<article>
<h1>head、SEO 与性能</h1>
<p>这一页的标题、作者与发布时间,和上面的 JSON-LD 完全一致。</p>
</article>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "拾光笔记本",
"image": "https://example.com/notebook.jpg",
"description": "米色纸面,适合慢慢写。",
"brand": { "@type": "Brand", "name": "拾光" },
"offers": {
"@type": "Offer",
"price": "68.00",
"priceCurrency": "CNY",
"availability": "https://schema.org/InStock",
"url": "https://example.com/notebook"
}
}
</script>
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{ "@type": "ListItem", "position": 1, "name": "首页", "item": "https://example.com/" },
{ "@type": "ListItem", "position": 2, "name": "教程", "item": "https://example.com/tutorial" },
{ "@type": "ListItem", "position": 3, "name": "head 与 SEO" }
]
}
</script>
多个类型可以合并进一个 @graph 数组,减少脚本块;但不要为了「看起来完整」而标注页面上不存在的字段,搜索引擎会对不一致的内容降低信任。
资源提示:把等待提前,而不是加长
浏览器解析 HTML 时,很多资源要等到「发现」才会开始下载。资源提示的作用是提前告诉它: 这个文件马上要用,那个域名马上要连。用得好能省下几百毫秒,用不好会抢走真正关键资源的带宽。
preload 用于当前页面马上要用的资源,必须写 as,
浏览器才能给出正确的优先级与请求头;可选值包括 script、style、
font、image、fetch、document 等。
字体还要加 crossorigin,即使是同源——这是字体请求的 CORS 规则决定的,
漏了会下载两次。preload 只是提前下载,不会自动执行或应用,样式与脚本仍然需要原本的引用。
prefetch 是「下一个页面可能会用」,在浏览器空闲时低优先级下载,
缓存供后续导航使用;用多了会浪费流量与内存。
preconnect 提前完成 DNS、TCP 与 TLS 握手,适合即将使用的第三方源;
dns-prefetch 只做 DNS 解析,是它的轻量兜底。
modulepreload 针对 ES 模块,提前抓取并解析依赖图,比普通 preload 更适合模块入口。
还有一个更直接的开关:fetchpriority="high" 加在首屏大图上,
能显著改善最大内容绘制;但不要给所有资源都加 high,等于没加。
常见误用包括:preload 了页面根本没用到的文件;preload 样式表却忘了
as="style";把整个字体家族的五个字重全部 preload;
对同一个源同时写 preconnect 与 dns-prefetch 却不写 crossorigin。
检查方法很简单:打开开发者工具的 Network 面板,看有没有「未使用」的 preload 警告。
| 指令 | 时机与代价 | 适用 |
|---|---|---|
preconnect | 提前 DNS + TCP + TLS,占用连接 | 即将使用的第三方源,2 到 4 个为宜 |
dns-prefetch | 只解析域名,代价很小 | preconnect 的兜底,或不确定是否使用 |
preload | 当前页高优先级下载,占用带宽 | 首屏字体、关键图片、关键脚本 |
modulepreload | 抓取并预解析模块依赖 | ES 模块入口与关键依赖 |
prefetch | 空闲时低优先级下载 | 下一个页面的资源,别贪多 |
<!-- 第三方源:字体、图片 CDN -->
<link rel="preconnect" href="https://fonts.example.com" crossorigin>
<link rel="dns-prefetch" href="//cdn.example.com">
<!-- 首屏字体:注意 crossorigin -->
<link rel="preload" href="/fonts/noto-serif-sc.woff2" as="font"
type="font/woff2" crossorigin>
<!-- 模块入口 -->
<link rel="modulepreload" href="/assets/js/app.js">
<!-- 下一个页面:低优先级 -->
<link rel="prefetch" href="/media.html">
<!-- 首屏大图:直接提高优先级 -->
<img src="/cover.jpg" alt="窗边的书桌" fetchpriority="high">
<!-- 错误:缺 as,浏览器不知道该按什么优先级抓取 -->
<link rel="preload" href="/style.css">
<!-- 正确 -->
<link rel="preload" href="/style.css" as="style">
<!-- 错误:字体缺 crossorigin,会被抓取两次 -->
<link rel="preload" href="/font.woff2" as="font" type="font/woff2">
<!-- 正确 -->
<link rel="preload" href="/font.woff2" as="font" type="font/woff2" crossorigin>
PWA:让网页可以被安装
manifest 是一份 JSON,描述「当这个网站被安装到桌面或主屏时,应该长什么样」。
它通过 link rel="manifest" 引入,浏览器在满足条件时显示安装入口。
它不是离线能力的全部,却是「像应用一样存在」的起点。
关键字段:name 是完整名称;short_name 是图标下的短名,
建议 12 个字符内;icons 至少提供 192×192 与 512×512;
start_url 是启动时打开的地址;display 最常用
standalone,也可用 minimal-ui、fullscreen、
browser;theme_color 影响状态栏与任务栏,
background_color 是启动画面的底色;scope 限定可导航范围;
id 是应用身份,避免改了 start_url 之后被当成两个应用。
图标建议再提供一张 purpose="maskable" 的版本,图案留在中心 80% 的安全区内,
安卓会按自己的形状裁切。可安装条件大体是:HTTPS、有 manifest 且包含名称与
192/512 图标、start_url 与 display 合法;
传统上还需要注册一个带 fetch 处理的 Service Worker 来提供离线能力。
不同浏览器策略略有差异,但把这几个基础项做好,安装入口基本都会出现。
Service Worker 一句话:它是浏览器在后台运行的一段脚本,能拦截网络请求, 把资源缓存下来,让页面在离线或弱网时仍能打开。它不等于「离线优先」, 缓存策略要自己设计;对内容站来说,先做「导航请求的网络优先、静态资源的缓存优先」 通常是一个稳妥的起点。
<link rel="manifest" href="/manifest.webmanifest">
<meta name="theme-color" content="#587768">
<link rel="apple-touch-icon" href="/icons/apple-touch-icon.png">
{
"name": "拾光 HTML",
"short_name": "拾光",
"description": "从头到尾,读懂标记语言。",
"id": "/",
"start_url": "/",
"scope": "/",
"display": "standalone",
"orientation": "portrait-primary",
"background_color": "#faf7f0",
"theme_color": "#587768",
"icons": [
{ "src": "/icons/icon-192.png", "sizes": "192x192", "type": "image/png" },
{ "src": "/icons/icon-512.png", "sizes": "512x512", "type": "image/png" },
{ "src": "/icons/maskable-512.png", "sizes": "512x512", "type": "image/png", "purpose": "maskable" }
]
}
脚本与资源加载:defer、async 与 module
script 默认是「解析阻塞」的:浏览器读到它,就停下 HTML 解析,下载并执行,
然后继续。这保证了脚本执行时,它之前的 DOM 已经就绪,但也让首屏变慢。
defer 让脚本在后台下载,等文档解析完成后再按出现顺序执行,位于
DOMContentLoaded 之前;async 也是后台下载,但下载完立刻执行,
顺序不保证,可能在 DOM 解析完成前运行。需要依赖顺序的脚本用 defer,
完全独立的统计脚本用 async。
type="module" 天然是 defer 的,并且启用严格模式、模块作用域与 CORS;
同一个模块只会执行一次,import 的依赖会先加载。给模块再加
async,它会在依赖就绪后尽快执行。行内脚本不支持 defer 与 async,
写了也会被忽略;如果必须早执行又要操作 DOM,就把逻辑放进
DOMContentLoaded。
noscript 里的内容只在脚本被禁用时显示,适合放「请开启 JavaScript」
的提示或一个基础版链接;它不能捕获脚本运行时的错误。
base 元素会改变页面里所有相对 URL 的解析基准,包括链接、图片、
表单 action,甚至 #fragment。它只能有一个 href 生效,
且必须放在其他 URL 之前。单页应用使用 history API 时,base 与相对路径的组合极易出错,
除非确有必要,不要用它。
| 写法 | 是否阻塞解析 | 执行时机 | 顺序保证 |
|---|---|---|---|
<script> | 是 | 下载后立即执行 | 按出现顺序 |
<script defer> | 否 | 解析完成后,DOMContentLoaded 前 | 按出现顺序 |
<script async> | 否 | 下载完成即执行 | 不保证 |
<script type="module"> | 否 | 解析完成后(默认 defer) | 按模块依赖与出现顺序 |
<script type="module" async> | 否 | 依赖就绪后尽快 | 不保证 |
<p id="log">开始</p>
<script>
document.getElementById('log').textContent += ' → 内联经典脚本';
</script>
<script type="module">
// 内联模块同样是延迟执行的
document.getElementById('log').textContent += ' → 内联 module';
</script>
<script>
document.addEventListener('DOMContentLoaded', function () {
document.getElementById('log').textContent += ' → DOMContentLoaded';
});
</script>
<noscript>
<p>这个页面的交互需要 JavaScript。你仍然可以
<a href="/basic.html">阅读基础版</a>。
</p>
</noscript>
<!-- base 会改写所有相对地址的解析基准 -->
<!-- <base href="https://example.com/docs/"> -->
<!-- 只能有一个 href 生效,且要放在其他 URL 之前 -->
<!-- 使用 history API 的单页应用通常不需要 base -->
一份可直接抄用的完整 head
下面这份模板把前面几节的内容按实际加载顺序排好:编码与视口在最前, 标题与描述紧随其后,然后是规范化、分享信息、图标与 manifest, 最后是资源提示与脚本。注释写在每一块的旁边,方便按站点情况删改。
不必一次全部启用:先把必须与推荐的两层填好,再根据是否做多语言、是否需要离线、 是否有首屏大图,逐项加上按需部分。模板的意义是提醒你别漏,而不是让你全部照搬。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<!-- ===== 1. 必须 ===== -->
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
<!-- ===== 2. 标题与摘要 ===== -->
<title>页面主题:一句具体的说明 | 站点名</title>
<meta name="description" content="用一到两句话说清这个页面讲什么、对谁有用,控制在 120 字以内。">
<!-- ===== 3. 主题与配色 ===== -->
<meta name="color-scheme" content="light dark">
<meta name="theme-color" content="#faf7f0">
<meta name="theme-color" content="#2c332e" media="(prefers-color-scheme: dark)">
<!-- ===== 4. 规范地址与抓取 ===== -->
<link rel="canonical" href="https://example.com/page.html">
<meta name="robots" content="index, follow, max-image-preview:large">
<!-- ===== 5. 多语言(没有就删) ===== -->
<!-- <link rel="alternate" hreflang="zh-CN" href="https://example.com/zh/page"> -->
<!-- <link rel="alternate" hreflang="en" href="https://example.com/en/page"> -->
<!-- <link rel="alternate" hreflang="x-default" href="https://example.com/page"> -->
<!-- ===== 6. 分享卡片 ===== -->
<meta property="og:type" content="website">
<meta property="og:site_name" content="站点名">
<meta property="og:title" content="页面主题:一句具体的说明">
<meta property="og:description" content="分享出去时显示的两行字。">
<meta property="og:url" content="https://example.com/page.html">
<meta property="og:image" content="https://example.com/cover.jpg">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:image:alt" content="封面图的内容描述">
<meta name="twitter:card" content="summary_large_image">
<!-- ===== 7. 图标与安装 ===== -->
<link rel="icon" href="/favicon.svg" type="image/svg+xml">
<link rel="icon" href="/favicon.ico" sizes="32x32">
<link rel="apple-touch-icon" href="/apple-touch-icon.png">
<link rel="manifest" href="/manifest.webmanifest">
<!-- ===== 8. 资源提示(按需,别贪多) ===== -->
<link rel="preconnect" href="https://cdn.example.com" crossorigin>
<link rel="preload" href="/fonts/serif.woff2" as="font" type="font/woff2" crossorigin>
<!-- ===== 9. 样式与脚本 ===== -->
<link rel="stylesheet" href="/assets/css/style.css">
<script src="/assets/js/main.js" defer></script>
<!-- ===== 10. 结构化数据(按需) ===== -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "站点名",
"url": "https://example.com/"
}
</script>
</head>
<body>
<h1>页面主题</h1>
</body>
</html>
除了 charset 与 viewport,其他标签的先后对功能影响很小。真正重要的是「不漏」与「一致」:canonical 与 og:url 一致,JSON-LD 与页面内容一致,图标与 manifest 指向真实存在的文件。
上线前检查清单
文档头的工作很容易在改版中悄悄退化:复制模板时漏掉 canonical,换域名后忘了改 og:url,新增页面没有独立 title。把下面几项写进上线流程,比事后排查省力得多。
- 每页有唯一、准确的
title与description,没有复制粘贴的重复摘要。 charset在前 1024 字节内,文件本身是 UTF-8,服务器响应头一致。viewport包含width=device-width,没有禁止缩放。- 每页有自引用的绝对
canonical,并且与og:url一致。 robots没有在正式页面误写noindex,测试环境则相反。- 分享卡片在真实平台调试工具里能抓到标题、描述与图片,图片为 1200×630。
- JSON-LD 通过验证,且每个字段都能在页面上找到对应内容。
- 图标、manifest、字体等引用路径真实存在,控制台没有 404。
- 只 preload 了首屏真正使用的资源,Network 面板没有「未使用」警告。
- 脚本使用 defer 或 module,没有在 head 里留下阻塞解析的同步脚本。
- 用键盘与读屏软件走一遍,页面标题与语言声明正确。
- 把全站页面 canonical 到首页,导致其他页面无法被索引。
- 用 robots.txt 挡住页面,又指望 noindex 生效。
- og:image 使用相对路径或 localhost 地址。
- 结构化数据里写页面没有的评分、价格与库存。
- 为了「性能优化」preload 十几个资源,反而拖慢首屏。
- 用
base改写路径,却没检查锚点与表单提交。
三个小练习
- 为你自己的一个页面写 title 与 description,分别控制在 30 字与 100 字以内。
- 用 Open Graph 与 Twitter Card 各写一套分享信息,并画一张 1200×630 的封面草图。
- 给一篇示例文章加上 Article 类型的 JSON-LD,再用验证工具检查一遍。
head 是页面的自我介绍。它不喧哗,却决定了别人如何找到你、如何看见你。把每一行都写准确,剩下的交给内容本身。