用 Hexo 搭建博客踩坑记录
为什么选 Hexo
其实静态博客生成器有很多选择——Hugo、Jekyll、Astro……但我最终选了 Hexo，原因很简单：生态成熟，主题多，中文文档齐全。作为一个前端不太行的人，能直接用别人做好的主题真是太幸福了。
踩坑合集
坑1：Node 版本不兼容
Hexo 8.x 需要 Node.js 14+，但如果你用了太新的 Node（比如 22），有些插件会报错。建议用 Node 18 LTS，稳如老狗。
坑2：主题配置覆盖
Hexo 的配置优先级是：_config.[theme].yml > 主题目录下的 _config.yml。如果你在主题目录里改了配置，又在根目录创建了 _config.redefine.yml，前者会被忽略。别问我怎么知道的。
坑3：部署后 CSS 丢失
如果部署到子目录（比如 username.github.io/blog），需要在 _config.yml 中设置正确的 url 和 root：
1 | url: https://username.github.io/blog |
坑4：Live2D 看板娘 scriptFrom 配置
scriptFrom: npm 在某些环境下会生成错误的脚本路径 <script src="npm">，需要改用 CDN 地址：
1 | scriptFrom: https://cdn.jsdelivr.net/npm/live2d-widget@3.1.4/lib/L2Dwidget.min.js |
总结
搭博客的过程虽然踩了不少坑，但折腾本身也是一种乐趣。看着自己的小站一点点完善，那种成就感是无可替代的。
写博客最难的不是搭站，而是坚持写 📝
- 标题: 用 Hexo 搭建博客踩坑记录
- 作者: Enco
- 创建于 : 2026-04-20 15:00:00
- 更新于 : 2026-05-22 00:23:36
- 链接: https://enco-shark.github.io/2026/04/20/用Hexo搭建博客踩坑记录/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。