第一版的响应式是标准的 @media (max-width: 768px) 三档断点,也能用。但我越用越别扭:手机和桌面共用一套 DOM,只是缩放,形态差异做不出来。 具体痛点是:文档模式在手机上需要「侧栏变抽屉」,在平板上需要「侧栏变折叠面板」,在桌面上才是常驻三栏。这三件事用宽度断点写,会变成一堆互相打架的 @media 补丁。 于是我改成了自适应式响应(adaptive):先识别设备档位,再交付该档专属布局。

主题写到三分之一时我发现一件事:只要有一个组件偷偷写了 #fff,深色模式就永远修不干净。你会在深夜里对着某个灰底白字的卡片怀疑人生,而它的兄弟卡片一切正常。 这一篇讲我用「设计令牌」把这类问题一次性解决的思路——不是理论,是这套主题里真正在跑的分层。

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