Skip to content

更新与优化日志 (CHANGELOG)

架构重构与路由优化

🚀 核心优化

  1. 动态侧边栏生成 (.vitepress/sidebarUtils.mjs)

    • 彻底移除了 config.mjs 中近 3800 行的硬编码路由配置,将配置体积缩减了 95%。
    • 实现了基于各个模块下 目录.md 的全自动路由生成机制。
    • 增加了智能文件名匹配逻辑:自动抹平 目录.md 中的带空格名称(如 1.1 安装Xcode 15)与真实物理文件中的下划线(1.1_安装Xcode_15.md)名称差异,完美防止了生成的路由出现 404 的情况。
  2. 自动补全 目录.md 结构

    • 为原本只在 config.mjs 中硬编码而缺乏物理目录文件的专栏(如 swiftui/100daysswiftui/animationswiftui/custom_views 等多个模块),自动生成并补齐了对应的 目录.md 文件,实现了项目结构的统一。

🐛 缺陷修复

  1. 修复了导航栏 (Nav) 高亮丢失问题

    • 修正了 .vitepress/config.mjsnav 配置项的 activeMatch 正则表达式。将错误的匹配规则(如 '^/(100days|base|...)/')更正为了正确层级(如 '^/swiftui/'),确保点击进入子文章后,顶部的导航菜单能够正确保持点亮状态。
  2. 修复了图片等静态资源的 404 问题

    • 将根目录中放错位置的 images 文件夹统一规范化转移到了 public/images/ 中,使其符合 VitePress 的静态资源解析规则,解决了 About 页面等地方图片无法显示的问题。
    • 修正了 config.mjs 里面 head 配置项的 logo.svg 相对路径错误(从 ./logo.svg 更正为绝对路径 /logo.svg)。
  3. 修复了已被废弃的 collapsible API

    • 新的动态侧边栏生成脚本默认采用了最新的 collapsed: false 属性,替代了已经被 VitePress 标记为废弃的 collapsible: true 属性,消除了终端编译时的过时警告。

📝 后续维护指南

以后撰写新文章或调整文章顺序时,永远无需再触碰 config.mjs。 只需要在对应专栏的 目录.md 文件中按顺序添加、修改或移动你的文章名称,左侧侧边栏即可全自动热更新。

本站使用 VitePress 制作