使用覆盖配置避免主题更新时丢失自定义配置
本文最后更新于:2025年7月9日 凌晨
1、覆盖配置
使用覆盖配置可以独立于主题更新,避免主题配置在更新时被冲掉。使用NPM安装主题可忽略此问题。
基于hexo6.3.0(5.0.0版本以上操作相同):将主题的_config.yml配置文件复制,并修改名称为_config.fluid.yml:

将复制的文件放入hexo博客根路径:

后续如果修改任何主题配置,通过_config.fluid.yml配置文件来修改。
- 配置文件优先级:
_config.fluid.yml>_config.yml,在存在主题配置文件时直接修改原_config.yml是无效的
注: 每次主题更新之后,注意更新说明,可能需要手动修改_config.fluid.yml同步配置。
2、验证覆盖配置
修改_config.fluid.yml文件中的一个配置来检查是否生效,将博客标题修改为新值,原配置文件_config.yml还是保留着之前的值:

重新生成页面查看效果:
1 | |
检查博客名称是否被覆盖。覆盖了原来的配置,验证OK:

也可通过命令行输出来检查配置是否生效:
1 | |
3、将覆盖配置为空
如果想将某些配置覆盖为空,直接将键值给注释掉,其主键无需注释,否则无法覆盖的,比如要要将about页面中的图标置空,使用下面的配置:
1 | |
icons为键名将其保留,注释掉其中的键值,使其将原配置置空。
HEXO:fluid主题使用覆盖配置
http://blog.codestar.top/website/hexo-set-fluid-config.html