vuepress打包之后页面样式丢失问题的两种解决方式
问题描述
最近打算使用vuepress为公司项目集成一下前端开发文档，在打包的时候遇到了样式丢失的问题，在网络上参考了一些解决方案，记录一下自己遇到的问题
1.集成打包之后，打开入口文件展示页面如下：
2.在本地直接运行的页面是没有问题的，
如图，只是打包之后样式丢失：
3.关于打包的dist文件目录结构如下：
dist
│ 404.html
│ index.html // 入口文件
│
├─assets
│ ├─css
│ │ 0.styles.3294b3f2.css
│ │
│ ├─img
│ │ search.83621669.svg
│ │
│ └─js
│ 2.733019b2.js
│ 3.b92b6444.js
│ 4.fc333d27.js
│ 5.d58e9858.js
│ 6.2d0a63f8.js
│ 7.9c9172a7.js
│ 8.9e1014e2.js
│ app.972414f3.js
│
└─guide
index.html解决方案
解决方案有两种，可以自行选择，vuepress我安装的版本如下，vuepress的路由模式写的是history模式，所以解决方案主要是面向两种不同模式（hash / history）
"vuepress": "^1.9.9" // 我安装的时候最新版本是1.9.9，^符号表示每次install都升级到最新版本
方案一 hash模式
1.修改依赖文件更改路由模式：在依赖文件夹node_modules下找到@vuepress，打开如图所示的app.js文件夹，将文件夹中的mode:history注掉，使用默认的hash模式
2.修改vuepress的config.js文件，主要更改的是base的这个配置项，base配置项在官网已经说得很明白了，可以去看一下，由于配置的默认base是’/‘即根目录，从根目录直接读取样式文件自然是找不到的，所以在这里改成相对路径’./’
module.exports = {
title: '开发文档',
description: '开发文档',
base: './', // 使用相对路径，读取相对路径下的静态文件
};
打包，本地访问入口文件，样式没有丢失的问题，发布到服务器上样式也正常，问题解决。
方案二 history模式
考虑到在实际开发中，多人维护文档，每个人都去改vuepress的路由模式有点麻烦，所以只需要修改config.js文件的base配置项即可
module.exports = {
title: '开发文档',
description: '开发文档',
base: '/project-docs/', // project-docs可以随意更改，主要看自己的文件放在服务器上的文件路径
};
比如nginx配置的location如下， 那么我们通过服务端口去访问的时候，找的是根目录html下的project-docs文件夹读取对应的静态文件
location /project-docs {
root html;
index index.html index.htm;
}修改完成后直接进行打包，在本地访问index.html还是会样式丢失的，但是问题不大，放上服务器后就可以正常访问了。
总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。
相关文章
Vue中使用vue2-perfect-scrollbar制作滚动条
这篇文章主要介绍了Vue中使用vue2-perfect-scrollbar滚动条,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2022-06-06
这篇文章主要给大家介绍了关于vue中使用file-saver导出文件的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下2022-02-02
本篇文章主要介绍了vue-router 权限控制的示例代码，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧2017-09-09
el-form表单el-form-item验证规则里prop一次验证两个或多个值问题
这篇文章主要介绍了el-form表单el-form-item验证规则里prop一次验证两个或多个值问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2023-05-05
Vue 按照创建时间和当前时间显示操作(刚刚,几小时前,几天前)
这篇文章主要介绍了Vue 按照创建时间和当前时间显示操作(刚刚,几小时前,几天前)，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2020-09-09
下面小编就为大家分享一篇解决Vue打包之后文件路径出错的问题，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧2018-03-03
目前前端最流行的网络请求库还是axios,所以对axios的封装很有必要,下面这篇文章主要给大家介绍了关于vue3中封装Axios请求及在组件中使用的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下2023-04-04
Vue是一个以数据驱动、组件化的前端框架,其中组件化是Vue中较为重要的概念之一,组件之间的通信则成为Vue中较为普遍的需求,下面这篇文章主要给大家介绍了关于vue父子组件传值不能实时更新的解决方法,需要的朋友可以参考下2023-05-05
本篇文章记录仿写一个el-tooltip组件细节，从而有助于大家更好理解饿了么ui对应组件具体工作细节，本文是elementui源码学习仿写系列的又一篇文章，后续空闲了会不断更新并仿写其他组件2023-07-07
这篇文章主要介绍了elementUi 中table表尾插入行的实例，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教2022-07-07
最新评论