hexo配置笔记

hexo 配置的一些相关问题笔记

Hexo 用起来轻，但 _config.yml 里几个字段配错了，表现会很诡异——文章日期穿越、链接 404、本地预览正常部署后样式全丢。这篇记我当年踩过的点。

发布时间不对的问题

细心的小伙伴会发现我的博客有些文章居然发布日期比更新日期还要晚，这是因为我的时区没有配置好的原因。

在站点根目录 _config.yml 里设置：

timezone: Asia/Shanghai

改完重新 hexo clean && hexo g。Hexo 按 UTC 解析 front matter 里的时间时，没写时区就会偏 8 小时，列表排序看起来像「未来文章」或发布晚于更新。

front matter 里建议写全：

date: 2019-10-28 17:20:14
# 或 ISO 格式带时区
date: 2019-10-28T17:20:14+08:00

常用配置顺手检查

站点 URL 与部署路径

url: https://你的域名
root: /

GitHub Pages 子路径站点要把 root 设成 /repo名/，否则 CSS、图片绝对路径全挂。

permalink

permalink: :year/:month/:day/:title/

和现有文章 URL 冲突时别随便改，除非做好重定向。

highlight

换主题后代码高亮风格不对，看 highlight.enable 和主题是否自带 renderer。

本地预览与生产

hexo s          # 本地
hexo cl && hexo g -d   # 生成并部署（视你的 deploy 配置）

hexo server 不清理旧 public 时，偶尔看到过期页面，养成改配置后 hexo clean 的习惯。

后来为什么换 Hugo 了

Hexo 生态成熟，但多主题、多插件时 Node 版本和依赖也会缠在一起。这篇保留作迁移前的备忘；现在主站已是 Hugo，时区问题的本质一样：静态站生成器都信你写的日期字符串。

先把 timezone 配对，至少列表页不会再像时间旅行。

版权声明: 本文首发于 指尖魔法屋-hexo配置笔记（https://blog.thinkmoon.cn/post/512_hexo%E9%85%8D%E7%BD%AE%E7%AC%94%E8%AE%B0/） 转载或引用必须申明原指尖魔法屋来源及源地址！