本文关键词：hexo 增加友情链接

做外链这行干了十二年，见过太多人为了个友情链接焦头烂额。特别是用 Hexo 这种静态博客框架的朋友，每次想加个友链，要么改代码改到怀疑人生，要么装个插件结果跟主题冲突，页面直接白屏。今天我不讲那些高大上的理论，就聊聊我怎么用最笨、最稳的方法，搞定 hexo 增加友情链接这个问题。

先说个真事儿。上个月有个做 SEO 的朋友找我，说他的站权重掉得厉害，问我怎么通过友链拉升。我让他别整那些自动交换的脚本，太容易被百度判定为链接农场。他用的就是 Hexo，主题叫 Butterfly。他之前试过装个“友链”插件，结果每次 hexo g 生成静态文件的时候都报错，查日志查了一晚上，最后发现是插件里的 YAML 格式有个缩进错了，肉眼根本看不出来。

这就是痛点。对于咱们这种追求稳定、不想天天维护一堆乱七八糟插件的人来说，手动改代码虽然听起来累，但其实最可控。下面我就把这套“土办法”拆解开来，你照着做，保证稳如老狗。

第一步，确定你的主题结构。Hexo 的主题千变万化，但核心逻辑差不多。你得找到主题目录下，专门用来渲染“关于”或者“友链”页面的文件。以 Butterfly 主题为例，通常在 themes/butterfly/source/ 或者 themes/butterfly/layout/ 下面有个 links 或者 friends 相关的文件夹。如果你用的是 NexT，那就去 layout/_partials 里找。别慌，找不到就全局搜索关键词“link”，Ctrl+F 搜一下，总能定位到那个渲染友链列表的 EJS 或 Pug 文件。

第二步，修改数据源。这是最关键的一步。很多主题把友链数据写死在模板里，你要把它改成读取外部 JSON 或 YAML 文件。比如，我在 Hexo 的 source/_data 目录下新建了一个 links.yml 文件。为什么选这个目录？因为 Hexo 支持从 _data 目录加载数据到页面，这样你就不用每次改代码，只需要改这个 YAML 文件就行。

文件内容大概长这样：

  • name: 张三博客

    • url: https://zhangsan.com

    avatar: https://zhangsan.com/avatar.jpg

    desc: 一个写代码的

    注意，这里有个坑。YAML 对缩进非常敏感，空格不能用 Tab，必须用两个空格缩进。我之前就是随手敲了个 Tab，结果生成页面时，友链列表直接不显示了，找半天才发现是缩进问题。这种小错误，百度爬虫可能不在乎，但用户体验大打折扣。

    第三步，修改模板文件。找到刚才定位到的 EJS 文件，比如 links.ejs。把里面硬编码的 HTML 列表删掉，换成遍历刚才那个 YAML 数据的代码。大概逻辑是：

    <% site.data.links.forEach(function(link) { %>

    <%= link.name %>

    <% }) %>

    这样，你以后只要改 YAML 文件，刷新一下本地预览，友链就自动更新了。这就叫“数据与结构分离”，是程序员的基本素养，也是 hexo 增加友情链接最高效的方式。

    第四步，测试与部署。改完代码，别急着 hexo d 部署。先在本地 hexo s 启动服务，打开浏览器看看。重点检查三点：链接能不能点开？图片能不能加载？移动端显示正不正常？我之前就遇到过图片路径不对，导致友链头像全裂开的情况，最后发现是相对路径写成了绝对路径，结果在自己电脑上能看，部署到 GitHub Pages 就挂了。这种细节，只有真刀真枪干过的人才懂。

    最后，说说心态。做外链，尤其是友链，别太急功近利。百度喜欢的是自然、相关、高质量的链接交换。你把自己的站点维护好，内容更新勤快点，再去联系同行交换友链，成功率才高。别去那些群发友链软件里混，那些链接不仅没用，还可能把你带进黑名单。

    这套方法虽然看起来有点“笨”，但它稳定、透明、可控。你完全掌握着数据的主动权，不用依赖第三方插件的更新和维护。对于像我这样做了十几年外链的老兵来说，这种“笨功夫”才是最踏实的。希望这篇 hexo 增加友情链接的实操指南，能帮你省去那些无谓的折腾。记住，技术是为内容服务的，别本末倒置。