Hexo 换主题踩坑记:配置到底改哪一层

两个配置文件

Hexo 的配置容易让人迷糊:根目录一个 _config.yml,主题目录里还有一个。

简单记法是:

  • 站点相关(标题、作者、文章链接格式)改根目录那份
  • 主题外观(菜单、侧边栏、评论、颜色)改主题那份

如果主题支持独立配置文件,比如 _config.anzhiyu.yml,那就优先改它,主题升级时不容易被覆盖。

改了没生效怎么办

遇到过好几次「明明改了配置,刷新还是老样子」,排查下来基本是下面几种:

  1. 改错文件,改的是主题自带的默认配置,被根目录的覆盖了
  2. 缓存在作怪,hexo clean 之后重新生成就好
  3. 缩进出错,YAML 对空格非常敏感,多一个空格整段就失效

YAML 报错的时候不要慌,先看报错行号,八成是缩进或冒号后面的空格。

生成到哪个目录

hexo generate 默认输出到 public,如果 Nginx 的站点根目录指的就是它,重新生成后刷新即可,不需要重启服务。

小结

配置这件事,搞清楚「谁覆盖谁」就解决了一大半问题。剩下的,交给 hexo clean。