<main>标签是HTML5定义的唯一主内容语义标记,必须全局唯一、不得嵌套于<header>等分区元素内,且仅包裹真正构成页面主题的内容;滥用会导致无障碍访问失败、SEO摘要错乱及Lighthouse报错。
main 标签不是用来“撑结构”或“加样式”的,它是给屏幕阅读器、搜索引擎和 Lighthouse 等工具看的语义锚点——用错或滥用,会直接导致无障碍跳转失败、SEO 摘要错乱、检测工具报错。
<main>
因为 HTML5 规范明确定义它为 document’s main content(文档的主内容),不是“主要内容之一”。
Tab 或快捷键跳转到主内容时,只认第一个 <main>;后面多个会被忽略或引发逻辑冲突Document has a main landmark 会因重复或缺失直接扣分<main> 中的内容混为同一主题,导致摘要提取偏差(比如把页脚版权当成正文)app/layout.tsx 里放 <main> 是常见错误——这里属于全局壳层,真正页面主体必须落在 app/page.tsx 或动态路由的 page.tsx 内部<main> 能嵌套在 <header> 或 <footer> 里吗不能。HTML5 明确禁止 <main> 作为 <header>、<footer>、<aside>、<nav> 的子元素。
<main>,或将其语义降级为普通容器<header><main>...</main></header> —— 这会让“登录入口”“搜索框”等导航相关元素被误判为核心内容<body> 的直接子元素,或至少与 <header>、<footer> 并列<template> 包裹多个根节点,需确保 <main> 不被意外塞进父级语义区块内<main>,什么不该判断标准只有一个:**去掉它,当前页面是否还表达完整主题?**
立即学习“前端免费学习笔记(深入)”;
<nav aria-label="Breadcrumb">)、页脚版权、侧边栏“相关推荐”、页眉 Logo 和登录入口<aside> 或 <section>,而非 <main>
<main> 必须与客户端 hydration 后的结构一致,否则 React/Vue 可能丢弃语义信息<main> 会怎样?用 role="main" 替代行不行不用 <main> 不会崩,但等于主动放弃可访问性基础设施支持;而用 role="main" 替代反而更危险。
<main> 的支持已全覆盖(IE11 除外),无需 polyfillrole="main" 是 ARIA 1.0 的遗留写法,与原生 <main> 共存时,部分读屏器会触发两次跳转,或优先采用 ARIA 导致原生语义失效role="main" 到 <div> 上,此时再手动加 <main> 就构成双重声明,Lighthouse 会报 Duplicate main landmarks
role="main" 都加 aria-hidden="true" 配合隐藏备用 <main>
最常被忽略的一点:页面 URL 主题变了,<main> 的边界就得重划。比如从 /products 切到 /products/123,前者主内容是列表,后者必须是单个商品详情——不能复用同一段 DOM 结构包着两个不同粒度的内容。