更新与优化日志 (CHANGELOG)
架构重构与路由优化
🚀 核心优化
动态侧边栏生成 (
.vitepress/sidebarUtils.mjs)- 彻底移除了
config.mjs中近 3800 行的硬编码路由配置,将配置体积缩减了 95%。 - 实现了基于各个模块下
目录.md的全自动路由生成机制。 - 增加了智能文件名匹配逻辑:自动抹平
目录.md中的带空格名称(如1.1 安装Xcode 15)与真实物理文件中的下划线(1.1_安装Xcode_15.md)名称差异,完美防止了生成的路由出现 404 的情况。
- 彻底移除了
自动补全
目录.md结构- 为原本只在
config.mjs中硬编码而缺乏物理目录文件的专栏(如swiftui/100days、swiftui/animation、swiftui/custom_views等多个模块),自动生成并补齐了对应的目录.md文件,实现了项目结构的统一。
- 为原本只在
🐛 缺陷修复
修复了导航栏 (Nav) 高亮丢失问题
- 修正了
.vitepress/config.mjs中nav配置项的activeMatch正则表达式。将错误的匹配规则(如'^/(100days|base|...)/')更正为了正确层级(如'^/swiftui/'),确保点击进入子文章后,顶部的导航菜单能够正确保持点亮状态。
- 修正了
修复了图片等静态资源的 404 问题
- 将根目录中放错位置的
images文件夹统一规范化转移到了public/images/中,使其符合 VitePress 的静态资源解析规则,解决了 About 页面等地方图片无法显示的问题。 - 修正了
config.mjs里面head配置项的logo.svg相对路径错误(从./logo.svg更正为绝对路径/logo.svg)。
- 将根目录中放错位置的
修复了已被废弃的
collapsibleAPI- 新的动态侧边栏生成脚本默认采用了最新的
collapsed: false属性,替代了已经被 VitePress 标记为废弃的collapsible: true属性,消除了终端编译时的过时警告。
- 新的动态侧边栏生成脚本默认采用了最新的
📝 后续维护指南
以后撰写新文章或调整文章顺序时,永远无需再触碰 config.mjs。 只需要在对应专栏的 目录.md 文件中按顺序添加、修改或移动你的文章名称,左侧侧边栏即可全自动热更新。