如何使用 Broken-Link-Checker 快速发现网站中的404错误和死链

如何使用 Broken-Link-Checker 快速发现网站中的404错误和死链

【免费下载链接】broken-link-checkerFind broken links, missing images, etc within your HTML.项目地址: https://gitcode.com/gh_mirrors/br/broken-link-checker

Broken-Link-Checker 是一款强大的工具，能够帮助您轻松找出网站中的404错误和死链，确保网站链接的完整性和用户体验。无论是个人博客还是大型商业网站，定期检查并修复 broken links 都是维护网站健康的重要环节。

快速安装：三步完成配置 🚀

1. 全局安装（推荐）

通过 npm 命令可以快速全局安装 Broken-Link-Checker：

npm install broken-link-checker -g

2. 本地项目安装

如果您希望在特定项目中使用，可以选择本地安装：

npm install broken-link-checker

3. 验证安装

安装完成后，输入以下命令验证是否安装成功：

blc --help

如果看到命令帮助信息，则说明安装成功。

四种核心检查模式：满足不同场景需求

1. 网站整体检查（SiteChecker）

最常用的检查方式，递归扫描整个网站的所有页面：

blc http://yoursite.com -ro

-ro参数表示只显示错误链接并输出详细报告。

2. 单页面链接检查（HtmlUrlChecker）

检查单个网页中的所有链接：

const {HtmlUrlChecker} = require('broken-link-checker'); const htmlUrlChecker = new HtmlUrlChecker(options); htmlUrlChecker.enqueue('http://example.com/page.html');

3. HTML 内容检查（HtmlChecker）

直接检查 HTML 字符串中的链接：

const {HtmlChecker} = require('broken-link-checker'); const htmlChecker = new HtmlChecker(options); htmlChecker.enqueue('<a href="https://example.com">Test</a>');

4. 单个 URL 检查（UrlChecker）

快速验证单个 URL 是否有效：

const {UrlChecker} = require('broken-link-checker'); const urlChecker = new UrlChecker(options); urlChecker.enqueue('https://example.com');

实用命令示例：轻松上手

检查本地 HTML 文件

blc path/to/index.html -ro

常见错误原因解析

Broken-Link-Checker 提供了详细的错误原因，例如：

const {reasons} = require('broken-link-checker'); console.log(reasons.HTTP_404); // 输出: Not Found (404)

高级应用：自定义检查规则

通过配置选项可以实现更精确的检查控制，例如：

• 设置请求超时时间
• 排除特定域名
• 自定义 User-Agent
• 处理认证需求

详细的配置选项可以查看项目源码中的 默认选项定义。

为什么选择 Broken-Link-Checker？

• 全面性：支持 HTTP/HTTPS、本地文件、FTP 等多种协议
• 高效性：内置缓存机制，避免重复检查
• 灵活性：提供 CLI 和 API 两种使用方式
• 可扩展性：通过事件监听自定义处理逻辑

定期使用 Broken-Link-Checker 检查您的网站，不仅可以提升用户体验，还能帮助搜索引擎更好地索引您的内容，提升网站 SEO 表现。立即尝试，让您的网站远离死链困扰！

【免费下载链接】broken-link-checkerFind broken links, missing images, etc within your HTML.项目地址: https://gitcode.com/gh_mirrors/br/broken-link-checker