点击展开更新日志

2025

11-23

【新增】 Hexo及主题升级操作

nexttime

会有些什么呢(❁´◡`❁)

源起

一直用的 Hexo 版本还是去年部署时的 7.3.0，看到最新已经到了 8.1。原本几周前就打算升级的，只是一直没找到教程，正好最近 Gemini3 出世，试过之后感觉很强，问了一下，直接就给出了升级操作。

注意事项

  1. 升级前建议备份项目下 config.yaml ，source ，package.json 等文件，避免升级出现问题时及时回退；

Hexo 升级操作

这里我用的包管理工具为 yarn ，因此如果你用的是 npm，记得更换命令

  1. 检查当前 hexo 版本

    1
    hexo version

    显示版本为 7.3.0

  2. 更新核心依赖：主要更新 package.json 依赖性

    1
    2
    3
    4
    5
    6
    7
    8
    9
    yarn upgrade hexo --latest
    yarn upgrade hexo-cli --latest
    yarn upgrade hexo-generator-archive --latest
    yarn upgrade hexo-generator-category --latest
    yarn upgrade hexo-generator-index --latest
    yarn upgrade hexo-generator-tag --latest
    yarn upgrade hexo-renderer-ejs --latest
    yarn upgrade hexo-renderer-stylus --latest
    yarn upgrade hexo-renderer-marked --latest

    如果网络报错，请自行解决

  3. 检查并安装缺失依赖

    1
    yarn install

  4. 清理缓存重新生成

    1
    2
    hexo clean
    hexo generate

  5. 运行本地服务检查

    1
    hexo server

如果一切正常且本地运行也没有什么问题，基本就大功告成了。之后重新检查 hexo 版本和查看 package,json 版本，都可以看到已经更新了。

主题升级操作

以 butteryfly 为例

绝对不建议直接修改主题目录下任何东西，主题配置请复制到根目录下 _config.butteryfly.yml 中修改。如果已经不巧做过修改了，备份内容然后删除重新拉取。

  1. 进入主题目录拉取最新代码

    1
    2
    cd themes/butteryfly
    git pull

  2. 对照最新主题配置文件，修改博客根目录下 _config.butteryfly.yml 文件，也可以一并查阅 Github 更新日志获取更新内容。虽然不会出现大幅变动，但也不建议直接拿最新配置使用。