如何正确解决VuePress本地访问出现资源报错404的问题

(编辑:jimmy 日期: 2024/12/23 浏览:2)

背景

最近发现好多小伙伴刚用VuePress,然后一build完就直接用本地浏览器访问,结果出现黑块。仅仅出现那种问题还好,给项目安装 vuepress-plugin-serve 插件就行了,
但是如果有需求是需要离线查看 VuePress 生成后的文档呢?所以我特地研究了一下——

解决办法

打开 .vuepress/config.js 文件,把 base 的值改成 ./,为了方便调试,最好这样写:

//base: "/",
base: "./",

写两个,一个用于Dev,一个用于Build。

然后打开项目下的 node_modules\@vuepress\core\lib\client 下的 app.js 文件,找到下方这个片段:

 const router = new Router({
 base: routerBase,
 mode: 'history',
 fallback: false,
 routes,
 scrollBehavior (to, from, savedPosition) {
  if (savedPosition) {
   return savedPosition
  } else if (to.hash) {
   if (Vue.$vuepress.$get('disableScrollBehavior')) {
    return false
   }
   return {
    selector: decodeURIComponent(to.hash)
   }
  } else {
   return { x: 0, y: 0 }
  }
 }
})

把 mode: 'history', 注释掉就行了(让它默认为 hash 模式)。

这样一来,就可以快乐地Build项目啦!