# 架构

4 篇文章

我在给主题加一处站点级样式时,写过这样一段注释:「必须放在最后加载,否则压不住主题那条规则」。 这句话本身就是问题——它意味着项目的样式顺序靠加载顺序这种隐晦的约定维系,谁挪一下文件位置,页面就悄悄变样。后来我把这套东西换成了 @layer,这类约定就消失了。

市面上的 Hexo 主题并不少,但我还是从零写了一套。不是因为现成的不好,而是因为我的三类内容根本不是同一种东西:博客文章要的是卡片流和挂件栏,笔记要的是能连续翻阅的侧栏树,文档要的是三栏加翻页。用一套博客模板硬套这三种场景,总有一头别扭。 这个系列记录 hexo-theme-xfm 从 efc52bd 首次提交到 v1.3.0 的完整开发过程——包含设计决策、真实代码,以及那些让我调试到怀疑人生的坑。