使用主题 matery 而降级 Hexo 版本

这是 2024 年从 Hexo 7.0.0 回退到 5.4.0 时的排错记录，Node.js 16 也是当时的环境。它们不代表使用 Matery 就必须采用这些旧版本；本博客当前已经能够使用 Hexo 8 构建。

先排查代码块显示

当时最直接的问题是代码块显示异常。先检查博客根目录 _config.yml 是否同时启用了两套高亮，按主题需要只保留对应方案。原文采用 Prism：

highlight:
  enable: false
  line_number: true
  auto_detect: false
  tab_replace: ''
  wrap: true
  hljs: false

prismjs:
  enable: true
  preprocess: true
  line_number: true
  tab_replace: ''

保存后重新生成并预览页面：

npx --no-install hexo generate
npx --no-install hexo server

如果仍有问题，检查主题版本、渲染插件和页面错误。hexo server 是本地预览；修改主题或依赖前保留可恢复的原版本。

确实需要回退时

先备份源码、主题及其本地改动、配置文件、package.json 和 package-lock.json。保留原项目，在副本或独立分支中验证，不需要先删除原博客，也不要在现有项目目录重新执行 hexo init。

下面仅保留原文的历史版本命令：

npm install hexo@5.4.0

它用于复现当时的依赖组合，不是通用修复。Node.js 版本必须结合目标 Hexo、渲染器和其他插件一起检查；单次报错不足以判断为“Node 版本过高”，也不应把旧版 Node 长期作为默认开发环境。

如果只是想做一个全新的对照站点，可在另一个空目录初始化：

hexo init blog-test --no-install

--no-install 只跳过依赖安装，仍会创建站点文件。该命令与现有博客的修复是两种操作，不要把测试站点直接覆盖回原项目。最终以完整构建和预览结果决定是否保留变更。