Doxygen 1.17版本文件列表丢失目录展开与层级选择功能

核心排查方向 #

自定义模板兼容性问题 #

你早先修改过的通用模板，大概率和Doxygen 1.17的文件列表渲染逻辑不兼容了——新版可能调整了目录展开依赖的JS/CSS结构、DOM元素命名，旧模板的自定义代码适配不上新版机制，直接导致控件失效。

• 验证方式：备份当前自定义模板，用Doxygen 1.17默认模板生成文档，观察展开功能是否恢复。如果默认模板正常，就确定是自定义模板的问题。
• 修复步骤：对照Doxygen 1.17自带的默认模板（重点看files.html、dir_*.html相关模板文件），更新你之前修改的部分，同步新版的渲染逻辑。

配置项隐性变更 #

虽然你没在更新日志找到相关内容，但可能存在配置项的行为调整：

• 检查已有配置项：比如SHOW_DIRECTORIES、DIRECTORY_GRAPH这类控制目录展示的选项，在1.17版本中是否有行为变化。
• 查看官方配置文档：确认1.17是否新增了控制文件列表层级展开的专属配置项，比如类似ENABLE_FILE_TREE_EXPANSION的开关。
• 重置排查：先把配置文件恢复到默认值，再逐步添加你的自定义配置，定位是否是配置冲突导致功能失效。

新版默认输出调整 #

如果用默认模板生成后依然没有展开控件，那可能是Doxygen 1.17有意修改了文件列表的默认样式：

• 自行适配：参考旧版模板的目录展开逻辑，在新版默认模板基础上重新添加交互功能（比如补全展开/折叠的JS代码、对应CSS样式）。
• 反馈确认：到Doxygen官方issue平台提交问题，确认这是默认行为改动还是bug。

版本对比 #

• Doxygen 1.16 文件列表：
  
• Doxygen 1.17 文件列表：
  

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