外链与死链检查工具

链接检查是维护网站质量的关键,确保用户体验和 SEO 表现。

保持网站链接的有效性和质量。

自动链接检查

本站已集成 CI 自动链接检查功能,在每次构建时自动检查新增或修改内容中的链接和图片。

检查范围

  • 外部链接可达性验证
  • 内部链接文件存在性检查
  • 图片链接有效性验证
  • 详细统计报告和错误汇总

使用方法

# 运行完整测试套件(包含链接检查)
npm test

# 仅运行链接检查并显示摘要
npm run link-check

输出示例

系统会生成详细的检查报告,包括:

  • 检查的文件数量
  • 发现的链接和图片统计
  • 失效链接的详细信息
  • 错误类型和状态码

其他链接检查工具

除了 CI 集成的自动检查,还可以使用以下工具进行全站链接检查。

HTMLProofer

HTMLProofer 是 Ruby 工具,专门用于检查 HTML 文件中的链接。

# 安装
gem install html-proofer

# 检查站点
htmlproofer ./_site --check-html --check-opengraph --check-img-http

LinkChecker

LinkChecker 是一个命令行工具,支持递归检查链接。

# 安装
pip install LinkChecker

# 检查站点
linkchecker https://example.com

Screaming Frog

商业工具,提供可视化界面和详细报告。

配置和优化

排除特定链接

在检查时排除某些链接:

# HTMLProofer 排除示例
htmlproofer ./_site --url-ignore "/admin/,/private/"

性能优化

  • 只在 PR 时检查新内容
  • 缓存检查结果
  • 并行检查多个文件

本站实践

本站的链接检查集成在 GitHub Actions 中:

- name: Check links
  run: npm run link-check
  continue-on-error: true

通过定期检查,确保链接质量,维护良好的用户体验。

总结

链接检查是网站维护的重要环节,通过自动化工具,可以及时发现和修复失效链接,提升站点质量。