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

网络编程 2024/12/27 佚名

3 2 1

背景

最近发现好多小伙伴刚用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项目啦！

VuePress本地访问404,VuePress本地访问