Hexo Butterfly 主题副标题不显示问题解决方案

问题描述在 Hexo 根目录的_config.yml中配置了subtitle但网站没有显示副标题。问题原因配置位置错误Butterfly 主题的副标题配置不在 Hexo 根目录的_config.yml中而是在主题配置文件themes/butterfly/_config.yml中。错误的配置方式 ❌在 Hexo 根目录_config.yml中配置title:Aetiks Blogsubtitle:欢迎来到 Aetik 的博客# ← 这样配置不会生效正确的配置方式 ✅在主题配置文件themes/butterfly/_config.yml中配置subtitle:enable:trueeffect:truesource:falsesub:-欢迎来到 Aetik 的博客解决方案步骤 1找到主题配置文件打开themes/butterfly/_config.yml文件步骤 2定位到 subtitle 配置找到第 169-187 行左右的配置# The subtitle on homepagesubtitle:enable:true# Typewriter Effecteffect:true# Customize typed.jstyped_option:# Source - Call the third-party service API (Chinese only)source:false# If you close the typewriter effect, the subtitle will only show the first line of subsub:# ← 这里是空的步骤 3添加副标题内容在sub:下面添加你的副标题sub:-欢迎来到 Aetik 的博客步骤 4重新生成网站hexo clean hexo g hexo s配置说明完整配置示例1. 静态副标题无动画subtitle:enable:trueeffect:false# 关闭打字机效果source:falsesub:-欢迎来到 Aetik 的博客2. 打字机动画效果subtitle:enable:trueeffect:true# 启用打字机效果source:falsesub:-欢迎来到 Aetik 的博客-你在抱怨什么呢-为明天到来的事说人生像是没有意义-没有选择会是唯一的路3. 使用第三方 API一言subtitle:enable:trueeffect:truesource:1# 1 hitokoto.cn 一言sub:-默认副标题可用的 API 源false- 不使用 API只显示sub中的内容1- hitokoto.cn一言2- https://api.aa1.cn/doc/yiyan.html3- jinrishici.com今日诗词配置参数详解参数说明可选值enable是否启用副标题true/falseeffect是否启用打字机动画效果true/falsetyped_option自定义 typed.js 配置参考 typed.js 文档source第三方 API 源false/1/2/3sub副标题内容数组字符串数组常见问题Q1: 为什么我配置了还是不显示检查清单是否在正确的文件themes/butterfly/_config.yml中配置enable是否设置为truesub是否有内容不能为空是否执行了hexo clean hexo gQ2: 如何实现多个副标题轮播在sub中添加多个条目sub:-第一个副标题-第二个副标题-第三个副标题Q3: 如何关闭打字机效果显示静态副标题subtitle:enable:trueeffect:false# 关闭动画sub:-静态副标题Q4: 副标题显示优先级是怎样的如果配置了sourceAPI优先显示 API 返回的内容然后显示sub中的内容最佳实践推荐配置方式使用_config.butterfly.yml文件主题升级时配置不会丢失在 Hexo 根目录创建_config.butterfly.yml添加配置subtitle:enable:trueeffect:truesource:falsesub:-欢迎来到 Aetik 的博客配置优先级_config.butterfly.yml themes/butterfly/_config.yml效果展示打字机效果副标题会像打字一样逐字显示显示完成后会删除并重新显示支持多个副标题轮播静态效果直接显示副标题文本无动画效果参考资料Butterfly 主题官方文档Butterfly 主题配置文件详解typed.js 文档更新日期2026-03-16适用版本Hexo 5.0.0Butterfly Theme 3.0