面包屑导航需手动维护而非自动推导，纯静态页中必须通过HTML硬编码或构建脚本注入路径映射，确保每级链接真实有效且语义正确，兼顾SEO、可访问性与用户体验。
面包屑导航本质是手动维护的路径结构，不是自动推导的
HTML5 静态网页没有服务端或路由系统，document.location.pathname 只能拿到当前 URL 路径，但无法自动知道「首页 → 产品 → Web 工具 → 编辑器」这样的语义层级。所谓“自动识别目录层级”在纯静态页里并不存在——所有文字、链接、分隔符都得你写死或用 JS 显式构造。
常见错误是直接按 / 拆分 pathname 后逐级拼链接，结果生成 /product/ → /product/web-tools/ → /product/web-tools/editor.html，但实际项目中这些路径可能根本不存在，或者中间某层是伪目录（如 category.html?id=web-tools）。
- 面包屑必须与网站真实的导航逻辑对齐，不能只依赖 URL 结构
- 推荐把面包屑数据内联在页面 HTML 中（比如用
data-breadcrumb属性），而不是靠 JS 解析 URL 猜测 - 如果全站统一结构，可用构建脚本（如 Python 或 Node.js）在生成 HTML 时注入，但纯手写静态页就只能硬编码
用 HTML+CSS 实现最简可靠面包屑（无 JS 依赖）
不依赖 JavaScript 是静态页最稳的方式。核心是写明每一级的文本和目标链接，用 > 或 / 做视觉分隔，语义上用 包裹。
注意点：
立即学习“前端免费学习笔记（深入）”；
-
- 当前页用
aria-current="page"标记，不加标签，避免无效跳转- 分隔符建议用 CSS 伪元素（
::before）添加，不要直接写youjiankuohaophpcn在 HTML 里，方便后期换图标或隐藏- 移动端需确保最小点击区域 ≥ 44px，
外边距/内边距别设太小用 JavaScript 动态生成时，必须预定义路径映射表
如果真要用 JS 自动渲染，唯一靠谱做法是提前写好路径到文案的映射，而不是解析 URL。否则 /blog/2023/10/15/my-post.html 就会变成「首页 / blog / 2023 / 10 / 15 / my-post」，完全不可读。
示例：在页面底部加一段内联脚本
关键约束：
- 映射表必须覆盖所有可能访问的 HTML 路径，漏掉一个就会回退到默认「首页」
- 相对路径计算（如
'.'.repeat(i) + '/'）只适用于扁平目录结构；若混用子目录和根目录文件，必须用完整路径 - 不要用
window.location.href，它含协议和域名，容易误匹配；只用pathname
SEO 和可访问性容易被忽略的细节
Google 会解析
itemListElement微数据或 JSON-LD。纯视觉面包屑对 SEO 几乎无贡献。更实际的问题是：用户从搜索引擎点击进来，看到的面包屑是否指向真实可访问的上层页面？例如搜索“html5 编辑器”，命中
/products/web-tools/editor.html，但面包屑里「Web 工具」链接却是/docs/web-tools.html（已 404），这就损害信任。- 每级链接上线前必须人工验证 HTTP 状态码为 200
- 中文站点慎用
/作分隔符（易与路径混淆），优先用>或 SVG 箭头 - 深色模式下检查分隔符颜色对比度，
#999在#333背景上不达标 - 如果某类页面（如 404、搜索结果页）不该显示面包屑，就在对应 HTML 里直接不写
- 当前页用
