Docusaurus自动生成侧边栏：分类索引页未被识别问题求助

• 检查侧边栏配置文件（通常是sidebar.js），确保开启了自动生成侧边栏的配置，示例如下：

module.exports = {
  sidebar: [
    {
      type: 'autogenerated',
      dirName: '.', // 替换为foo文件夹所在的根目录路径
    },
  ],
};

如果是手动编写了侧边栏的子项，自动分类索引规则会失效，必须切换到自动生成模式。

• 校验文件与文件夹的大小写匹配：部分系统（如Linux）对路径大小写敏感，确保foo文件夹和foo.md的大小写完全一致。

• 检查foo.md的front matter：若存在sidebar_position或id字段，可能干扰索引识别。可删除这两个字段，或把sidebar_position设置为0，强制它作为分类的首项被识别为索引页。

• 清理缓存重新构建：执行npm run clear或yarn clear清除缓存，再运行npm run build或yarn build重新生成站点，避免缓存导致的配置不生效。

• 确认Docusaurus版本：旧版本可能存在规则支持bug，升级到最新稳定版后重试。

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