Hugo Blowfish主题多级嵌套菜单创建异常问题求助

检查menus.en.toml的层级配置 #

Blowfish主题的菜单嵌套完全依赖配置文件中parent字段的正确关联，必须确保每个子菜单的parent严格对应父菜单的identifier（若父菜单指定了该字段）或name（未指定identifier时），大小写完全匹配。

正确的三级嵌套配置示例：

[[main]]
name = "Support"
identifier = "support"
url = "/support/"
weight = 3

[[main]]
name = "Downloads"
identifier = "downloads"
parent = "support"
url = "/support/downloads/"
weight = 1

[[main]]
name = "Sapphire"
parent = "downloads"
url = "/support/downloads/sapphire/"
weight = 1

• 遗漏parent字段的菜单会被自动识别为顶级主菜单，这是你遇到问题的核心原因之一。

验证content目录结构与菜单的对应关系 #

确保content目录的层级和菜单配置完全匹配，示例结构如下：

content/
└── support/
    ├── _index.md
    └── downloads/
        ├── _index.md
        └── sapphire/
            └── _index.md

• 每个section目录下必须存在_index.md文件，用来标记这是一个可访问的section页面，否则Hugo无法正确解析层级关系，进而导致菜单渲染异常。
• 菜单中的url路径要和实际section的URL完全一致，注意检查Hugo配置中是否启用了uglyURLs等影响URL结构的选项。

确认Blowfish主题的菜单渲染配置 #

检查主题配置文件（如config/_default/config.toml），确保菜单嵌套功能未被禁用，且层级深度设置足够：

[params]
  menu = { enable = true, depth = 3 } # depth值需大于等于你的菜单层级，比如3对应三级嵌套

• 若depth值小于实际菜单层级，子菜单会被截断，无法正常显示嵌套结构。

清除缓存并重新构建 #

Hugo的缓存可能会导致旧配置未更新，执行以下命令彻底重建：

hugo clean && hugo server

内容的提问来源于stack exchange，提问作者Emreceng