问题记录

VitePress 文件夹缺少 index.md 导致 404

问题描述

在 VitePress 项目中新建文件夹后，访问对应路径报 404 错误。

原因分析

VitePress 的路由规则要求每个菜单文件夹下必须包含 index.md 文件，否则无法正常访问。

解决方案

在新建的文件夹下创建 index.md 文件，作为该目录的入口页面。

示例

docs/
├── api/           # 新建文件夹
│   ├── index.md   # ✅ 必须有这个文件
│   └── README.md
├── about/
│   ├── index.md   # ✅ 参考这个格式
│   └── ...

参考

• 官方文档 - 目录主页

---

其他问题

（待补充）