无效链接修复实战用 Front-End-Checklist 规则库保证链接可爬取、可传递 PageRank【免费下载链接】Front-End-Checklist The essential checklist for modern web development, for humans and AI agents项目地址: https://gitcode.com/gh_mirrors/fr/Front-End-Checklist导读本文围绕 Front-End-Checklist 开源仓库中的invalid-links无效链接SEO 规则展开讲解如何审计页面中所有a元素、识别空 href、javascript:伪链接、缺失 href 等不可爬取形态并给出修复方案与源码级验证依据。读完本文你将掌握一套可直接落地的链接有效性检查清单、修复步骤与浏览器 DevTools 验证命令并了解该规则在仓库 crawler 与 MCP 代码审查工具中的实际落地方式。规则定位与适用场景invalid-links规则位于 Front-End-Checklist 的 skills/invalid-links/SKILL.md其元信息明确标注了适用场景审计页面链接元素的可爬取性crawlability审查大量依赖 JavaScript 导航的 SPA单页应用其中导航可能没有使用a href标签检查动态生成的链接是否带有合法的 href 值该规则的分类为seo、子分类technical优先级medium难度intermediate预计耗时 10 分钟与仓库内容规则同源packages/content/rules/en/seo/invalid-links.mdx。核心事实Google 只会跟从声明为合法a href元素且 href 为可爬取 URL 值的链接。无效链接——空 href、JavaScript 伪链接、非 URL 内容——会阻断 PageRank 流向目标页面并阻止 Googlebot 发现这些目的地。什么是无效链接五种必须标记的形态根据规则文档SKILL.md审计时需要解析页面上所有a元素并按类型统计以下五类问题#无效形态示例说明1空 hrefhref或href#无有效目标空值对爬虫无意义2javascript:伪协议hrefjavascript:void(0)不指向任何 URL3mailto:/tel:协议hrefmailto:...、hreftel:...合法但不可用于页面发现4指向不存在锚点的片段标识href#missing且页面无idmissing片段目标缺失5完全缺失 href 属性a无任何 href 属性不是可爬取链接规则的check提示见 packages/content/rules/en/seo/invalid-links.mdx要求按类型报告计数Report the count per type以便定位批量问题。为什么这些链接不可爬取Google 官方文档对可爬取链接的定义是必须是a元素而不是带点击处理器的div、span或button必须包含href属性href 值必须是合法的相对或绝对 URL不能是javascript:、void(0)或空值javascript:伪协议、空 href、缺失 href 的链接不会被爬虫跟从。这意味着仅通过无效链接可达的页面永远不会被 Googlebot 发现——即使该路由在你的前端路由器中真实存在。反模式示例四种常见错误写法以下代码均来自规则文档的 Code Examples直接可在代码审查中对照使用。❌ JavaScript void href不可爬取a hrefjavascript:void(0) onclicknavigate(/products)Products/a !-- Googlebot 看到 hrefjavascript:void(0)不会跟从 --❌ 缺失 href 属性a onclickgoToPage(/about)About Us/a !-- 没有 hrefGooglebot 无法跟从此链接 --❌ 空 hrefa hrefHome/a !-- 空 href不是合法的可爬取链接 --❌ div/span 导航SPA 中常见div onclickrouter.push(/contact) classnav-linkContact/div !-- 不是 a 元素对爬虫完全不可见 --修复方案四条黄金规则规则文档 Fix 部分给出了完整的修复流程1. 对hrefjavascript:void(0)或href#的导航触发器在 href 中填入真实 URL用 JavaScript 增强导航而不是取代导航!-- 修复前 -- a hrefjavascript:void(0) onclickopenModal()View Details/a !-- 修复后href 提供 URLJS 仅增强体验 -- a href/products/details onclickopenModal(event)View Details/a其中openModal内部通过event.preventDefault()阻止默认跳转、改为打开模态框同时保留 href 供爬虫与无 JS 环境使用script function openModal(event, url) { event.preventDefault() // 打开模态框而非跳转 showModal(url) } /script2. 对没有 href 的a用作按钮的元素若触发导航补上 href若仅触发动作改为button元素3. 对空href要么补上正确 URL要么移除a包裹4. 对href#锚点使用有意义的片段 ID且必须引用页面上真实存在的锚点a href#featuresJump to Features/a section idfeatures !-- idfeatures 真实存在 -- h2Features/h2 /section正确写法示例可爬取链接的标准形态✅ 合法可爬取链接a href/productsProducts/a a hrefhttps://example.com/aboutAbout Us/a a href/contactContact/a✅ JavaScript 增强但不破坏可爬取性的链接!-- href 为爬虫提供 URLJS 增强用户体验 -- a href/products/modal-details onclickopenModal(event, /products/modal-details) View Details /a✅ React Router / Next.js 链接规则文档特别给出了现代前端框架下的写法对照invalid-links.mdx// ✅ React Router —— 渲染为 a href/products Link to/productsProducts/Link // ✅ Next.js —— 渲染为 a href/about Link href/aboutAbout Us/Link // ❌ 避免 —— useNavigate 没有对应的 a button onClick{() navigate(/products)}Products/button // 这不可爬取请使用 Link 替代核心原则React Router / Next.js 的Link组件最终都会渲染为带 href 的a元素因此是安全的而裸的onClick/useNavigate处理器不会产生可爬取链接。为什么它重要三大影响规则文档 Why It Matters 总结了无效链接的三重代价发现失败Discovery failure仅通过无效a元素链接的页面可能永远不被 Googlebot 发现即使该路由在前端路由器中真实存在。PageRank 阻断无效链接无法向目标页面传递 PageRank。这与你站内链接体系internal-links 规则的健康度直接相关——无效链接破坏发现机制的方式与站内链接结构失衡如出一辙。可访问性受损无效链接同时通过不了可访问性检查——屏幕阅读器与键盘用户同样无法导航它们。源码级落地仓库中如何检测无效链接Front-End-Checklist 仓库不仅提供规则文档还在多个模块中真实落地了对链接的解析与审查逻辑可作为自动化检测的参考实现。crawler爬虫如何过滤无效链接仓库中的 packages/crawler/src/index.ts 定义了parseLinks函数用正则提取 HTML 中所有 href并显式跳过无效链接function parseLinks(html: string, baseUrl: string): string[] { const base new URL(baseUrl) const origin base.origin const links new Setstring() const hrefRegex /href\s*\s*[]/gi let match hrefRegex.exec(html) while (match ! null) { const raw match[1]!.trim() if (!raw || raw.startsWith(#) || raw.startsWith(mailto:) || raw.startsWith(tel:)) continue try { const url new URL(raw, baseUrl) if (url.origin ! origin) continue // ... links.add(normalized) } catch { // 忽略无效 URL } match hrefRegex.exec(html) } return Array.from(links) }这段代码印证了规则中的判断逻辑!raw对应空 href第 3 类raw.startsWith(#)对应片段标识第 4 类raw.startsWith(mailto:)/raw.startsWith(tel:)对应合法但不可爬取的协议第 3 类new URL(raw, baseUrl)抛错则对应语法非法的 URLMCP review_code静态审查工具如何发现链接问题仓库的 MCP 服务器提供review_code工具packages/mcp/src/tools/review-code.ts用于对前端代码执行保守的非穷尽静态启发式审查。它通过node-html-parser解析 HTML并在detectCategories中把a的出现自动归类为html/accessibility/seo类别review-code.ts从而触发对链接类规则的检查。其单元测试packages/mcp/tests/unit/review-code-detection.test.ts覆盖了a hrefhttps://example.com target_blank等链接场景的规则检测。从源码结构看review_code的设计原则是保守、可证明的静态检查只有能从代码片段中证明的问题才会被报告无法证明的则通过suggestions引导用户用get_rule(invalid-links)之类的工具调用获取完整规则上下文。边界情况Exceptions规则文档 Exceptions 明确了在审计中不应误报的场景暂存、工具类、登录、账号或站内搜索页面若本就不打算参与排名可能有意使用不同的爬取/索引信号。临时迁移状态迁移过程会产生噪声性的中间信号应标记线上正式环境的 URL 模式而非一次性过渡产物。信号冲突时当重定向、canonical、robots 指令或索引性信号互相冲突时先修复最强的最终信号而不是把每个下游症状都单独上报为阻塞项。验证清单如何确认修复完成自动化检查运行一次站内爬取筛选出未被跟从not followed的链接。可参考上述 crawler 的parseLinks逻辑将空 href、#、mailto:、tel:及解析失败的 URL 从可爬取链接集中剔除。手动检查使用浏览器 DevTools 的 Console 直接查询问题链接document.querySelectorAll(a:not([href]), a[href], a[href^javascript:])该命令一次覆盖三种最常见问题缺失 href、空 href、javascript:伪协议。随后审查 SPA 导航模式确保所有导航都使用Link或a href组件而不是裸onClick处理器修复方式补上真实 href 值或把非锚点元素替换为正确的a元素。验收标准Standards规则文档要求以两份权威资料作为最终验收基准invalid-links.mdxGoogle Search Central: Crawlable links可爬取链接规范MDN: The anchor elementa元素参考在将规则标记为已满足之前对照这两份标准核验最终的搜索可见 HTML、元数据与爬取行为。关联规则无效链接不是孤立问题。规则元数据中 relatedRules 列出了四个密切关联的 SEO 规则关联规则关联原因broken-links404 断链是相关问题——无效格式链接是另一种失败类型external-links外链也必须是带正确属性的合法a href元素https-downgrade同属seo/technical区域常一起审查weak-internal-links同属seo/technical区域常一起审查其中 internal-links 规则 进一步强调站内链接是 PageRank 在站点内流动的方式Googlebot 通过站内链接发现页面——一个没有入站链接的页面很可能就是孤儿页orphan page。这与本规则互为表里无效链接让链接这个通道本身失效。结语invalid-links规则揭示了 SEO 领域最容易忽略的细节之一链接不仅要存在还必须以爬虫能理解的形式存在。通过本文的五类检查清单、四条修复规则、框架级正确写法以及仓库 crawler 与 MCPreview_code的源码级印证你可以把链接可爬取性纳入常规的前端代码审查与站点审计流程从源头避免发现失败与 PageRank 流失。【免费下载链接】Front-End-Checklist The essential checklist for modern web development, for humans and AI agents项目地址: https://gitcode.com/gh_mirrors/fr/Front-End-Checklist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
无效链接修复实战用 Front-End-Checklist 规则库保证链接可爬取、可传递 PageRank【免费下载链接】Front-End-Checklist The essential checklist for modern web development, for humans and AI agents项目地址: https://gitcode.com/gh_mirrors/fr/Front-End-Checklist导读本文围绕 Front-End-Checklist 开源仓库中的invalid-links无效链接SEO 规则展开讲解如何审计页面中所有a元素、识别空 href、javascript:伪链接、缺失 href 等不可爬取形态并给出修复方案与源码级验证依据。读完本文你将掌握一套可直接落地的链接有效性检查清单、修复步骤与浏览器 DevTools 验证命令并了解该规则在仓库 crawler 与 MCP 代码审查工具中的实际落地方式。规则定位与适用场景invalid-links规则位于 Front-End-Checklist 的 skills/invalid-links/SKILL.md其元信息明确标注了适用场景审计页面链接元素的可爬取性crawlability审查大量依赖 JavaScript 导航的 SPA单页应用其中导航可能没有使用a href标签检查动态生成的链接是否带有合法的 href 值该规则的分类为seo、子分类technical优先级medium难度intermediate预计耗时 10 分钟与仓库内容规则同源packages/content/rules/en/seo/invalid-links.mdx。核心事实Google 只会跟从声明为合法a href元素且 href 为可爬取 URL 值的链接。无效链接——空 href、JavaScript 伪链接、非 URL 内容——会阻断 PageRank 流向目标页面并阻止 Googlebot 发现这些目的地。什么是无效链接五种必须标记的形态根据规则文档SKILL.md审计时需要解析页面上所有a元素并按类型统计以下五类问题#无效形态示例说明1空 hrefhref或href#无有效目标空值对爬虫无意义2javascript:伪协议hrefjavascript:void(0)不指向任何 URL3mailto:/tel:协议hrefmailto:...、hreftel:...合法但不可用于页面发现4指向不存在锚点的片段标识href#missing且页面无idmissing片段目标缺失5完全缺失 href 属性a无任何 href 属性不是可爬取链接规则的check提示见 packages/content/rules/en/seo/invalid-links.mdx要求按类型报告计数Report the count per type以便定位批量问题。为什么这些链接不可爬取Google 官方文档对可爬取链接的定义是必须是a元素而不是带点击处理器的div、span或button必须包含href属性href 值必须是合法的相对或绝对 URL不能是javascript:、void(0)或空值javascript:伪协议、空 href、缺失 href 的链接不会被爬虫跟从。这意味着仅通过无效链接可达的页面永远不会被 Googlebot 发现——即使该路由在你的前端路由器中真实存在。反模式示例四种常见错误写法以下代码均来自规则文档的 Code Examples直接可在代码审查中对照使用。❌ JavaScript void href不可爬取a hrefjavascript:void(0) onclicknavigate(/products)Products/a !-- Googlebot 看到 hrefjavascript:void(0)不会跟从 --❌ 缺失 href 属性a onclickgoToPage(/about)About Us/a !-- 没有 hrefGooglebot 无法跟从此链接 --❌ 空 hrefa hrefHome/a !-- 空 href不是合法的可爬取链接 --❌ div/span 导航SPA 中常见div onclickrouter.push(/contact) classnav-linkContact/div !-- 不是 a 元素对爬虫完全不可见 --修复方案四条黄金规则规则文档 Fix 部分给出了完整的修复流程1. 对hrefjavascript:void(0)或href#的导航触发器在 href 中填入真实 URL用 JavaScript 增强导航而不是取代导航!-- 修复前 -- a hrefjavascript:void(0) onclickopenModal()View Details/a !-- 修复后href 提供 URLJS 仅增强体验 -- a href/products/details onclickopenModal(event)View Details/a其中openModal内部通过event.preventDefault()阻止默认跳转、改为打开模态框同时保留 href 供爬虫与无 JS 环境使用script function openModal(event, url) { event.preventDefault() // 打开模态框而非跳转 showModal(url) } /script2. 对没有 href 的a用作按钮的元素若触发导航补上 href若仅触发动作改为button元素3. 对空href要么补上正确 URL要么移除a包裹4. 对href#锚点使用有意义的片段 ID且必须引用页面上真实存在的锚点a href#featuresJump to Features/a section idfeatures !-- idfeatures 真实存在 -- h2Features/h2 /section正确写法示例可爬取链接的标准形态✅ 合法可爬取链接a href/productsProducts/a a hrefhttps://example.com/aboutAbout Us/a a href/contactContact/a✅ JavaScript 增强但不破坏可爬取性的链接!-- href 为爬虫提供 URLJS 增强用户体验 -- a href/products/modal-details onclickopenModal(event, /products/modal-details) View Details /a✅ React Router / Next.js 链接规则文档特别给出了现代前端框架下的写法对照invalid-links.mdx// ✅ React Router —— 渲染为 a href/products Link to/productsProducts/Link // ✅ Next.js —— 渲染为 a href/about Link href/aboutAbout Us/Link // ❌ 避免 —— useNavigate 没有对应的 a button onClick{() navigate(/products)}Products/button // 这不可爬取请使用 Link 替代核心原则React Router / Next.js 的Link组件最终都会渲染为带 href 的a元素因此是安全的而裸的onClick/useNavigate处理器不会产生可爬取链接。为什么它重要三大影响规则文档 Why It Matters 总结了无效链接的三重代价发现失败Discovery failure仅通过无效a元素链接的页面可能永远不被 Googlebot 发现即使该路由在前端路由器中真实存在。PageRank 阻断无效链接无法向目标页面传递 PageRank。这与你站内链接体系internal-links 规则的健康度直接相关——无效链接破坏发现机制的方式与站内链接结构失衡如出一辙。可访问性受损无效链接同时通过不了可访问性检查——屏幕阅读器与键盘用户同样无法导航它们。源码级落地仓库中如何检测无效链接Front-End-Checklist 仓库不仅提供规则文档还在多个模块中真实落地了对链接的解析与审查逻辑可作为自动化检测的参考实现。crawler爬虫如何过滤无效链接仓库中的 packages/crawler/src/index.ts 定义了parseLinks函数用正则提取 HTML 中所有 href并显式跳过无效链接function parseLinks(html: string, baseUrl: string): string[] { const base new URL(baseUrl) const origin base.origin const links new Setstring() const hrefRegex /href\s*\s*[]/gi let match hrefRegex.exec(html) while (match ! null) { const raw match[1]!.trim() if (!raw || raw.startsWith(#) || raw.startsWith(mailto:) || raw.startsWith(tel:)) continue try { const url new URL(raw, baseUrl) if (url.origin ! origin) continue // ... links.add(normalized) } catch { // 忽略无效 URL } match hrefRegex.exec(html) } return Array.from(links) }这段代码印证了规则中的判断逻辑!raw对应空 href第 3 类raw.startsWith(#)对应片段标识第 4 类raw.startsWith(mailto:)/raw.startsWith(tel:)对应合法但不可爬取的协议第 3 类new URL(raw, baseUrl)抛错则对应语法非法的 URLMCP review_code静态审查工具如何发现链接问题仓库的 MCP 服务器提供review_code工具packages/mcp/src/tools/review-code.ts用于对前端代码执行保守的非穷尽静态启发式审查。它通过node-html-parser解析 HTML并在detectCategories中把a的出现自动归类为html/accessibility/seo类别review-code.ts从而触发对链接类规则的检查。其单元测试packages/mcp/tests/unit/review-code-detection.test.ts覆盖了a hrefhttps://example.com target_blank等链接场景的规则检测。从源码结构看review_code的设计原则是保守、可证明的静态检查只有能从代码片段中证明的问题才会被报告无法证明的则通过suggestions引导用户用get_rule(invalid-links)之类的工具调用获取完整规则上下文。边界情况Exceptions规则文档 Exceptions 明确了在审计中不应误报的场景暂存、工具类、登录、账号或站内搜索页面若本就不打算参与排名可能有意使用不同的爬取/索引信号。临时迁移状态迁移过程会产生噪声性的中间信号应标记线上正式环境的 URL 模式而非一次性过渡产物。信号冲突时当重定向、canonical、robots 指令或索引性信号互相冲突时先修复最强的最终信号而不是把每个下游症状都单独上报为阻塞项。验证清单如何确认修复完成自动化检查运行一次站内爬取筛选出未被跟从not followed的链接。可参考上述 crawler 的parseLinks逻辑将空 href、#、mailto:、tel:及解析失败的 URL 从可爬取链接集中剔除。手动检查使用浏览器 DevTools 的 Console 直接查询问题链接document.querySelectorAll(a:not([href]), a[href], a[href^javascript:])该命令一次覆盖三种最常见问题缺失 href、空 href、javascript:伪协议。随后审查 SPA 导航模式确保所有导航都使用Link或a href组件而不是裸onClick处理器修复方式补上真实 href 值或把非锚点元素替换为正确的a元素。验收标准Standards规则文档要求以两份权威资料作为最终验收基准invalid-links.mdxGoogle Search Central: Crawlable links可爬取链接规范MDN: The anchor elementa元素参考在将规则标记为已满足之前对照这两份标准核验最终的搜索可见 HTML、元数据与爬取行为。关联规则无效链接不是孤立问题。规则元数据中 relatedRules 列出了四个密切关联的 SEO 规则关联规则关联原因broken-links404 断链是相关问题——无效格式链接是另一种失败类型external-links外链也必须是带正确属性的合法a href元素https-downgrade同属seo/technical区域常一起审查weak-internal-links同属seo/technical区域常一起审查其中 internal-links 规则 进一步强调站内链接是 PageRank 在站点内流动的方式Googlebot 通过站内链接发现页面——一个没有入站链接的页面很可能就是孤儿页orphan page。这与本规则互为表里无效链接让链接这个通道本身失效。结语invalid-links规则揭示了 SEO 领域最容易忽略的细节之一链接不仅要存在还必须以爬虫能理解的形式存在。通过本文的五类检查清单、四条修复规则、框架级正确写法以及仓库 crawler 与 MCPreview_code的源码级印证你可以把链接可爬取性纳入常规的前端代码审查与站点审计流程从源头避免发现失败与 PageRank 流失。【免费下载链接】Front-End-Checklist The essential checklist for modern web development, for humans and AI agents项目地址: https://gitcode.com/gh_mirrors/fr/Front-End-Checklist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
