拾光 HTML从头到尾,读懂标记语言

第八章 · 文档头

head、SEO 与性能:写给机器看的第一屏

用户看不见 head,但浏览器、搜索引擎、社交平台和各种阅读器都先读它。 这一章把文档头里的元素分成「必须、推荐、按需」三层,再谈分享卡片、结构化数据、 资源提示与脚本加载顺序。最后附上一份可以直接抄用的完整模板。

阅读约 30 分钟 17 个示例 进阶难度 含实时预览

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> 开始标签。

<title><meta><link> <style><script><noscript> <template><base>
层级元素说明
必须 meta charset、meta viewport、title 缺一个,中文、移动端或标签页就会出问题
推荐 description、canonical、icon、theme-color、Open Graph 影响搜索摘要、分享卡片与浏览器外观
按需 robots、hreflang、manifest、preload、JSON-LD、color-scheme 按站点类型与性能目标逐项添加
html 一份带注释的 head 骨架
<!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>
head 不是仓库

把业务数据、大段 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 会暴露建站工具与版本,静态站点可以选择省略。

html 基础元信息完整小页面
<!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>
html 配色相关的几个 meta
<!-- 浅色模式与深色模式分别指定主题色 -->
<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:[数字]限制摘要长度精细控制展示范围
html 一篇文章页的 SEO 头部
<!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>
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 测试改标题,记得同步更新。

分享卡片是别人第一次看见你的方式,值得多花十分钟:选一张安静的封面, 写一句准确的描述,删掉最后那个多余的感叹号。

html Open Graph 最小完整集
<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">
html Twitter Card
<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="米色纸面上的标题与细线">
html 分享卡片的版式示意(纯 CSS)
<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 标记验证工具检查,前者看搜索引擎是否支持这种类型, 后者看语法与词汇是否规范。

html Article:文章页的 JSON-LD
<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>
html Product 与 BreadcrumbList
<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>
一段 JSON 就够

多个类型可以合并进一个 @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空闲时低优先级下载下一个页面的资源,别贪多
html 一组克制的资源提示
<!-- 第三方源:字体、图片 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">
html 两个常见错误
<!-- 错误:缺 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 一句话:它是浏览器在后台运行的一段脚本,能拦截网络请求, 把资源缓存下来,让页面在离线或弱网时仍能打开。它不等于「离线优先」, 缓存策略要自己设计;对内容站来说,先做「导航请求的网络优先、静态资源的缓存优先」 通常是一个稳妥的起点。

html 在 head 里引入 manifest
<link rel="manifest" href="/manifest.webmanifest">
<meta name="theme-color" content="#587768">
<link rel="apple-touch-icon" href="/icons/apple-touch-icon.png">
json 一份够用的 manifest
{
  "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>否依赖就绪后尽快不保证
html 内联脚本、模块与 DOMContentLoaded 的先后
<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>
html noscript 与 base 的边界
<noscript>
  <p>这个页面的交互需要 JavaScript。你仍然可以
    <a href="/basic.html">阅读基础版</a>。
  </p>
</noscript>

<!-- base 会改写所有相对地址的解析基准 -->
<!-- <base href="https://example.com/docs/"> -->

<!-- 只能有一个 href 生效,且要放在其他 URL 之前 -->
<!-- 使用 history API 的单页应用通常不需要 base -->

一份可直接抄用的完整 head

下面这份模板把前面几节的内容按实际加载顺序排好:编码与视口在最前, 标题与描述紧随其后,然后是规范化、分享信息、图标与 manifest, 最后是资源提示与脚本。注释写在每一块的旁边,方便按站点情况删改。

不必一次全部启用:先把必须与推荐的两层填好,再根据是否做多语言、是否需要离线、 是否有首屏大图,逐项加上按需部分。模板的意义是提醒你别漏,而不是让你全部照搬。

html 完整的 head 模板(含注释)
<!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 改写路径,却没检查锚点与表单提交。

三个小练习

  1. 为你自己的一个页面写 title 与 description,分别控制在 30 字与 100 字以内。
  2. 用 Open Graph 与 Twitter Card 各写一套分享信息,并画一张 1200×630 的封面草图。
  3. 给一篇示例文章加上 Article 类型的 JSON-LD,再用验证工具检查一遍。
写在最后

head 是页面的自我介绍。它不喧哗,却决定了别人如何找到你、如何看见你。把每一行都写准确,剩下的交给内容本身。