把博客从 WordPress 搬到 Hexo 后,我深度定制了 Sakura 主题,一路踩了不少坑:

  1. front-matter 必须写开头的 ---,漏了 hexo 完全不解析
  2. 模板里的转义字符会被构建器搞坏,字符串引号要用 HTML 实体
  3. 动画别直接改主题核心文件,自定义 CSS/JS 追加更安全
  4. 懒加载图片的 data-src 才是真实地址,别拿 src 当封面

这些经验写成文章,希望后来者少走弯路。