Hexo 升级教程文章分析

📋 文章概述

本文记录了将 Hexo 博客从 6.3.0 版本升级到 7.0.0 的完整过程,同时配合升级 hexo-theme-butterfly 主题至 4.11.0 版本。

本文转载自:https://note.weizwz.com/hexo/basic/hexo-update


🔧 完整升级步骤(含命令)

步骤 1:查看当前版本

1
hexo -v

作用: 确认当前 Hexo 版本(示例中为 6.3.0)

步骤 2:全局安装/更新 hexo-cli

1
npm i hexo-cli -g

作用: 全局更新 Hexo 命令行工具

步骤 3:安装 npm-check 工具(可选)

1
npm install -g npm-check

作用: 用于检查哪些依赖包需要更新

步骤 4:检查可更新的依赖项

1
npm-check

作用: 列出所有过时的依赖及其最新版本

步骤 5:安装 npm-upgrade 工具(可选)

1
npm install -g npm-upgrade

作用: 用于交互式更新 package.json 中的版本号

步骤 6:更新 package.json 配置文件

1
npm-upgrade

作用: 交互式选择要升级的依赖包,确认后写入 package.json

⚠️ 注意: 需要对每个升级项输入回车确认,最后一步需输入 yyes

步骤 7:执行实际升级

1
npm update --save

作用: 根据 package.json 下载并安装新版本的依赖包

步骤 8:验证升级结果

1
hexo version

作用: 确认 Hexo 已升级到目标版本(7.0.0)

步骤 9:升级主题并测试

1
2
npm update hexo-theme-butterfly --save
hexo server

作用: 更新 Butterfly 主题并启动本地服务器预览效果

✅ 升级完成标志

成功运行 hexo server 后,控制台输出显示:

1
2
3
4
5
#####  #    # ##### ##### ###### #####  ###### #      #   #
...
4.11.0
===================================================================
INFO Start processing

💡 提示: 以上命令均需在 Hexo 博客根目录下执行。如需实际执行这些操作,请确认您已了解各命令的作用,并建议提前备份 package.json_config.yml 等配置文件。