# ♥ 高级用法

# 侧边栏分组(多级目录)

当你的文档变多时,推荐用“分组 + children”的方式组织左侧目录。

  • 每个分组是一个对象:title / collapsable / sidebarDepth / children
  • children 里写相对路径(不带 .md

# 约定:README.md 对应目录首页

  • docs/guide/README.md -> /guide/
  • docs/features/README.md -> /features/

# 让右侧大纲更好用

建议每页都保持层级清晰:

  • #:页面标题(只出现一次)
  • ##:主章节(会进入右侧大纲)
  • ###:子章节(会进入右侧大纲,取决于 sidebarDepth

# 常见排查

  • 修改了 config.js 后没生效:重启 npm run dev
  • 图片路径 404:确认放在 docs/.vuepress/public/ 下,并用 /images/... 引用