652 字
3 分钟
简单升级 Hexo 的方法：一键三连助你轻松搞定
Hexo 是一款成熟的静态博客生成工具。随着版本的迭代（目前已迈入 Hexo 8.x 时代），新版本不仅大幅优化了生成速度，还对 TypeScript 和 现代 CSS 预处理器 提供了更好的支持。如果你还在使用 4.x 或 5.x 版本，是时候进行一次“无痛升级”了。
一、 准备工作：环境检查
在升级 Hexo 之前，必须确保你的底层环境（Node.js）满足新版本的运行条件。
- 检查 Node.js 版本： Hexo 7.0+ 要求 Node.js 版本至少为 v14.0.0，建议使用最新的 LTS 版本（如 v22.x）。
node -v- 备份配置文件：
备份你的
_config.yml和package.json，这是升级失败时的“后悔药”。
二、 升级流程：高效“三连”命令
1. 全局升级 hexo-cli
hexo-cli 是终端调用 hexo 命令的入口。首先将其更新至全球最新版：
npm install hexo-cli -g2. 使用 npm-check-updates (ncu) 检查依赖
传统的 npm-check 已逐渐被更现代、维护更频繁的 npm-check-updates (ncu) 取代。它能智能分析 package.json 并绕过 SemVer 的版本锁定。
- 安装 ncu（如未安装）：
npm install -g npm-check-updates- 检查更新： 在项目根目录下运行：
ncu它会列出所有可以升级的插件及其版本跨度。
3. 执行批量升级
确认列表无误后，执行以下命令同步更新 package.json：
ncu -u然后，执行安装命令让升级生效：
npm install三、 升级后的关键步骤
升级完成后，不要立即访问页面，先执行以下“清理三部曲”：
- 清理缓存与生成：
hexo clean && hexo g- 本地预览：
hexo s访问 http://localhost:4000，重点检查：
- 代码高亮：Hexo 7.0 对原生高亮做了重构，检查配置是否失效。
- 图片加载：确认
post_asset_folder相关插件是否正常。
四、 避坑小贴士 (2026 补充)
- 插件冲突：如果升级后报错
Error: Cannot find module...，通常是某些陈旧插件不再兼容新版 Hexo。建议在package.json中移除这些插件，寻找替代品。 - 主题升级：如果你使用的是 Next 或 Butterfly 等主题，Hexo 核心升级后，最好也同步更新主题文件，或者检查主题的
_config.yml是否有新的必填项。 - 锁定版本：如果项目非常稳定不想频繁折腾，升级后建议将
package.json中的版本号前的^去掉，锁定当前版本。
总结
通过 hexo-cli + ncu 的组合，升级 Hexo 不再是一件痛苦的事情。保持软件更新不仅能获得性能红利，更能规避许多已知的安全漏洞。
简单升级 Hexo 的方法：一键三连助你轻松搞定
https://sw.rscclub.website/posts/hexoupdate/