Skip to content

VuePress 从 1.x 升级到 2.x

背景

vuepress 1.x 使用 webpack 和旧的模块系统,需要全量编译,随着 markdown 文件增多,耗时变长,体验下降。对于静心只是写一些笔记来说,难以忍受,因此,我平时都不开 dev 服务,改用编辑器的预览插件。

vite 采用 ES6 module,浏览器原生支持,实现无刷更新。

有两个升级选择,一是迁到 vitepress,二是升级到 2.x。前者功能相对少,尝试后放弃。

升级问题

  • 配置不兼容

需要根据 2.x 文档,进行调整,主要变化涉及 sidebar、navbar,插件注册

  • md 元素标签处理错误

元素标签<hi />出现在标题和链接里,也会被解析为 Vue 组件,导致出错。

  • 不支持获取$site.posts,原自定义实现的 blog 功能无法使用

升级变更见代码 Merge branch 'migrate-v2' into dev · cyio/cyio.github.io@e3b2320

感受

优点:无刷更新,值得升级

缺点:首次启动开发服务、慢了很多