vscode内置链接检测仅高亮纯url且不验证有效性，无法提前发现重定向、404等错误；需用node脚本在构建/预提交阶段主动探测，关键在于路径解析、协议过滤、并发控制及状态码处理。
为什么直接用 VSCode 内置链接检测不够用
VSCode 原生的「Links」功能（在设置中开启 editor.links）只做基础文本识别：它能把 https://example.com 这类纯 URL 高亮并支持 Ctrl+Click 打开，但完全不验证有效性。遇到重定向、404、证书错误、跨域拦截或 DNS 失败时，点击后浏览器才报错——这已经晚了。你真正需要的是构建时/预提交阶段的主动探测，而不是编辑时被动响应。
用 Node 脚本批量检测 a/link/script 的 href/src
核心逻辑是：抓取 HTML → 提取所有外部资源地址 → 拼接成绝对 URL → 并发发起 HEAD/GET 请求 → 记录状态码与超时。关键点不在“能不能跑”，而在“怎么避免误报和卡死”：
-
必须区分相对路径与绝对路径：
/api/users要拼baseURL，./logo.png要转为${baseURL}/logo.png，而https://cdn.example.com/可直连 -
跳过非 HTTP 协议：
mailto:admin@example.com、tel:+8613800138000、javascript:void(0)这些不用发请求 -
限制并发数防封禁：默认用
axios发 100 个并发请求，目标站可能触发限流或防火墙；建议设maxRedirects: 0+timeout: 5000+ 控制并发 ≤ 10 - 忽略特定状态码也算“有效”：301/302 是正常重定向，不应标为失效；但 301 指向的最终地址仍需检查（可选）
示例提取逻辑片段（非完整脚本）：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
const $ = cheerio.load(html);
const urls = new Set();
$('a[href], link[href], script[src]').each((_, el) => {
const attr = $(el).is('script') ? 'src' : 'href';
let url = $(el).attr(attr);
if (!url || url.startsWith('#') || url.startsWith('mailto:') || url.startsWith('tel:')) return;
if (url.startsWith('http')) urls.add(url);
else if (url.startsWith('/')) urls.add(baseURL + url);
else urls.add(new URL(url, baseURL).href); // 安全处理 ./ ../ 等
});
如何让检测结果实时反馈到 VSCode 编辑器内
VSCode 本身不提供“运行自定义链接检测并高亮失败项”的 API，但你可以用两种方式桥接：
-
输出 JSON 报告 + 自定义问题匹配器：脚本最终生成
link-report.json，内容如[{"url":"https://bad.example.com","status":0,"error":"timeout"}]；然后在.vscode/tasks.json中配置一个 task，配合problemMatcher解析该 JSON，并把错误行映射回原始 HTML 文件中的对应标签位置（需提前记录行号） -
用 Terminal 面板手动触发 + 快速跳转：在
myLink.js里打印带文件名和行号的失败信息，例如：index.html:42 — https://old-cdn.com/js/app.js → 404；VSCode 默认支持点击xxx.html:xx自动跳转到该行 - 别硬塞进 Language Server：试图改写 TypeScript/JavaScript 语言服务来注入链接校验，成本远高于收益；这类检测本质是构建前检查，不是语言语义分析
容易被忽略的三个真实陷阱
很多脚本本地跑通，一上 CI 或换机器就失效，根源常在这三处：
-
HTTPS 证书绕过没生效：用了
rejectUnauthorized: false，但 axios 版本 ≥ 1.7 后需额外加httpsAgent: new https.Agent({ rejectUnauthorized: false })，否则仍会抛certificate has expired -
重定向链过长导致超时：某个
link[href]指向一个 302 页面，该页面又 302 到另一个，axios 默认只跟 5 次，第 6 次就报maxRedirects错；应显式设maxRedirects: 0并自己处理跳转逻辑 -
静态资源路径含 query 参数却未缓存穿透：如
style.css?v=1.2.3，CDN 可能对带v=的请求返回 404，但你本地开发时这个参数是构建工具注入的——检测时应剥离 query（或配白名单）
检测不是一次性的活。只要项目里还有手工写的 <a href="..."></a>，就得定期跑；把它塞进 precommit hook 或 CI 的 test 阶段，比依赖编辑器自动感知靠谱得多。
