VitePress侧边栏在index页面上出错，标题不会高亮，上下页链接缺失

发布于: 2026/01/25 17:51:21

VitePress网站建设

内容概要

此文介绍了解决VitePress有时对于index页面不能正确地读取其侧边栏配置并为其自动添加上下页链接的问题的方法

在使用VitePress的过程中发现，对于子文件夹中的index.md文件，有时VitePress不能正确地读取侧边栏配置并为其自动添加上下页链接。

现象

在子文件夹内创建index.md文件，并在侧边栏配置中写入/folder/index路径后，对应index页面内没有上页链接，而下页链接指向该页面本身。除此之外，当用户浏览该页面时，侧边栏内对应的标题并不会被高亮。

侧边栏配置示例：

export default {
  themeConfig: {
    sidebar: {
      '/sitelog/': [
        {
          text: '关于网站日志板块',
          items: [
            { text: '网站日志板块简介', link: '/sitelog/index' },
            { text: '网站日志', link: '/sitelog/logs' }
          ]
        }
      ]
    }
  }
}

渲染效果示例：

解决方法

将侧边栏配置路径中的index去除即可。例如，原先为/folder/index的路径，需要更改为/folder/，注意必须要以/结尾。

实测除了侧边栏配置以外，对于网站内其他位置出现的index页面链接，加不加index对此问题不会产生任何影响。

侧边栏配置示例：

export default {
  themeConfig: {
    sidebar: {
      '/sitelog/': [
        {
          text: '关于网站日志板块',
          items: [
            { text: '网站日志板块简介', link: '/sitelog/' },
            { text: '网站日志', link: '/sitelog/logs' }
          ]
        }
      ]
    }
  }
}

渲染效果示例：