说实话，刚接触 Hexo 那会儿，我连 Markdown 语法都还没背熟，就急着想去别人的博客留个言，结果连个评论框都找不着。后来自己搭了站，心里总痒痒，想挂个友链，显得这网站热闹点，不是那种荒草丛生的废弃地。但真到了 hexo中添加友情链接 这一步，才发现网上的教程要么太老，要么就是复制粘贴的废话，根本不管用。

记得那天晚上，我盯着屏幕上的 _config.yml 文件发呆，脑子有点木。我想加个友链，不是那种简单的文字链接，而是带头像、带描述的那种卡片式展示。网上搜了一圈，大多是要改主题源码，还要引入 JS 库，听得我头大。我就想，能不能简单点？毕竟我只是个写写技术笔记的，不是搞前端开发的。

最后没办法，只能硬着头皮去翻自己用的主题文档。我用的主题是 Butterfly，挺火的，但文档写得也是云里雾里。我试着在 source 文件夹里新建了一个 links.md 文件。这一步其实挺关键的，很多新手会直接改模板文件，结果下次更新主题就全没了，哭都来不及。我把链接数据写成 YAML 格式，大概长这样：

`yaml

link: https://example.com

avatar: https://example.com/avatar.jpg

desc: 一个热爱技术的家伙

`

写完之后，保存。然后去主题配置里找友链相关的配置项。这时候问题来了，我发现很多教程说要在 _config.yml 里开启友链功能，但我找了半天，压根没这个选项。后来才反应过来，有些主题是把友链做成一个独立的页面，而不是直接在首页显示。

我就去 GitHub 上看了作者的 Issues，发现有人问过类似的问题。原来，我需要在 layout 文件夹里找到对应的模板，或者更简单的，直接在 Hexo 的页面里调用数据。我试着在 source/links.md 里加了个 front-matter，指定 layout 为 links。结果刷新页面，一片空白。那一刻，我真的想砸键盘。

冷静下来后，我重新检查了文件路径。哦，原来 Hexo 的页面生成需要特定的文件名或者路径。我把文件名改成了 index.md 放在 source/links 目录下，再试了一次。嘿，页面出来了！但是样式乱得一塌糊涂，头像显示不出来，链接也没样式。

这时候我才意识到，光有数据不行，还得有样式。我不得不再去扒一下主题的 CSS 文件，看看友链模块用的类名是什么。这个过程挺枯燥的，一行行代码看过去，眼睛都酸了。好在最后找到了，把对应的 CSS 类名填进去，头像终于显示了。

这就是我在 hexo中添加友情链接 时的真实经历。没有那么多高大上的技巧，就是一个个坑填过去。现在回想起来，虽然过程有点粗糙，但那种看到友链页面完美呈现的成就感，真的挺爽的。

如果你也在折腾 hexo中添加友情链接 ，我有几个建议。第一，别盲目改主题源码，尽量通过配置文件或页面数据来实现，这样升级主题的时候少受罪。第二，多看看 GitHub 上的 Issues，很多坑别人已经踩过了。第三，耐心点，调试 CSS 的时候容易让人抓狂，喝杯茶，深呼吸。

最后，如果你实在搞不定，或者不想折腾这些细节，也可以来找我聊聊。我虽然不是什么大神，但这几年的折腾经验还是有点的。别客气，直接私信就行，咱们一起把这小站弄得漂漂亮亮的。毕竟，博客嘛，开心最重要，不是吗？